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PREFACE 



This publication is intended for system programmers who are to generate an OS/VS2 System 
Control Program. This publication does not explain the concepts underlying VS2 operations 
or the options available in VS2. Information of this type is contained in the following 
publications: 

OS/VS2 Planning and Use Guide, GC28-0600 

OS/ VS System Generation Introduction, GC26-3790 

IBM System/ 3 70 System Summary, GA22-7001 

This publication provides you with the information necessary to: 

• Prepare for system generation 

• Execute system generation 

• Restart system generation if errors occur during processing 

• Test the newly created System Control Program 

The information in this publication is divided into nine chapters and six appendixes. 

"Introduction," briefly defines system generation and discusses the three types of system 
generation: a complete system generation, a nucleus generation, and an I/O device generation. 
It also provides a list and explanation of the procedures for generating a VS2 System Control 
Program. 

"Requirements for Generating a New System Control Program," is divided into three sections. 
The first section gives the real-storage requirements for system generation. The second section 
discusses the machine requirements for system generation using the starter system. The third 
section tells about the programming requirements for system generation. 

"Specifying the New System Control Program," is divided into two sections. The first section 
explains the conventions used in this publication to present the system generation macro in- 
structions. The second section discusses the system generation macro instructions and what 
must be considered in specifying the new System Control Program. Included are: 

• The required and optional macro instructions for the three types of system generation 

• A list of the system generation macro instructions by type and in the order they should 
be considered 

• An explanation of each system generation macro instruction, given alphabetically by the 
macro instruction name. The format, parameters, and defaults of each macro are explained. 
Whether each macro instruction is required or optional is also shown 

• A coding example of each macro instruction 

"Selecting the New System Data Sets," describes the procedures for allocating space to the 
system data sets and cataloging them in the system catalog. Also included is a description of 
each of the required and optional system data sets and what must be considered in selecting and 
specifying them, and a summary description of the system data sets. 

"Preparation for System Generation," tells what to do before system generation. Included are 
discussions and examples of direct-access volume initialization, preparatory steps for using both 
the starter system and an existing VS2 system as the generating system, and an explanation of 
how to add your own routines to the new system during system generation. 



"System Control Program Installation," describes Stage I input, execution, and output, and 
Stage II input, execution, and output. 

"Restart Procedures," gives the procedures for restarting system generation if processing ends 
unsuccessfully during either Stage I or Stage II. 

"Testing the System Control Program," gives the procedures used to test the newly installed 
System Control Program using the installation verification procedure (IVP). 

"Examples of System Generation," presents examples that illustrate the generation of a particu- 
lar type of System Control Program and the various types of system generation. 

Appendix A, "Device Types," lists and describes the device types that can be specified in the 
UNIT parameter of the IODEVICE macro instruction. 

Appendix B, "Description of the Starter System and Distribution Library Tapes," discusses the 
contents of the starter system tape and distribution library tape, and lists the contents of the 
distribution library tape. 

Appendix C, "System Generation Messages," lists and explains the messages that are produced 
by the assembler program during Stage I. 

Appendix D, "Functionally Equivalent Devices," lists I/O device types that are functionally 
equivalent and discusses how they are specified in an IODEVICE macro instruction. 

Appendix E, "Diagnostic Override," gives the macro instructions that can be used to override 
errors that may occur during Stage I processing. 

Appendix F, "Console Sheet of the Procedures for Starting the Starter System," shows the 
commands and responses that are printed on the console during the procedure for making the 
starter system operational. 

The following items are described in this publication for planning purposes only, and will not be 
available with the initial release of VS2: 

• System/370 Model 155II 

• System/370 Model 16 511 

Availability dates for support of the above items may be obtained from the local IBM branch 
office. 

The following publications provide detailed explanation of job control language, utility programs, 
and coding macro instructions: 

OS/VS and DOS/ VS Assembler Language, GC33-4010 
OS/ VS JCL Reference, GC28-06 1 8 
OS/VS Utilities, GC3 5-0005 



IV 



The following publications are referred to in this manual. They provide detailed information 
about topics associated with system generation: 

OS I VS Assembler Programmer's Guide, GC334021 

OS/VSBTAM, GC27-6980 

OS/VS Checkpoint/Restart, GC26-3784 

OS/VS Data Management Macro Instructions, GC26-3793 

OS J VS Data Management for System Programmers, GC28-063 1 

OS/VS Data Management Services Guide, GC26-3783 

0S/VS2 Debugging Guide, GC28-0632 

OS/VS Graphic Programming Services (GPS) for IBM 2250 Display Unit, GC27-6971 

OS/ VS Graphic Programming Services (GPS) for IBM 2260 Display Station (Local A ttach- 
ment), GC27-6972 

OS/ VS Graphic Subroutine Package (GSP) for FOR TRAN IV, COBOL, and PL /I, 
GC27-6973 

OS/VS JCL Services, GC28-0617 

OS/VS Linkage Editor and Loader, GC26-38 1 3 

OS/VS SYSLLOGREC Error Recording, GC28-0638 

OS/VS Message Library: Service Aids and OLTEP Messages, GC38-1006 

OS/VS Message Library: Routing and Descriptor Codes, GC38-1004 

OS/VS Message Library: VS2 System Messages, GC38-1002 

OS/VS Message Library: VS2 System Codes, GC38-1008 

OS/VS OLTEP, GC28-0636 

Operator's Library: OS/VS Console Configurations, GC38-0120 

Operator's Library: OS /VS2 Display Consoles, GC38-0260 

Operator's Library: OS /VS2 Reference, GC38-0210 

Operator's Library: OS/VS TCAM, GC38-0305 

Operator's Library: OS/VS2 TSO, GC38-0220 

OS/VS Problem Determination Aids and Messages and Codes for GPS and GSP, GC27-6974 

OS/ VS Recovery Management Support Logic, SY27 -7239 

OS/VS Service Aids, GC28-0633 

OS/VS2 Storage Estimates, GC28-0604 

OS/ VS2 Supervisor Logic, SY2 7-7244 

OS/VS Supervisor Services and Macro Instructions, GC27-6979 

OS/VS2 System Data Areas, SY28-0606 

OS/VS System Management Facilities (SMF), GC35-0004 

OS/VS Tape Labels, GC26-3795 

OS TCAM Concepts and Facilities, GC30-2022 

OS/VS TCAM Programmer's Guide, GC30-2034 

OS/VS2 TSO Command Language Reference, GC28-0646 

OS/VS2 TSO Guide, GC28-0644 

OS/VS2 TSO Terminal User's Guide, GC28-0645 

An introduction to the IBM 3270 Information Display System, GA27-2739 
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SUMMARY OF AMENDMENTS 



Release 1.6 



VS2 Release 1 .6 now fully supports DSS (dynamic support system) and HASP. 

VS2 Release 1.6 now fully supports the System/370 central processing units, Model 158 
and Model 168. 

The SIZE parameter of the EDITOR macro has been changed to default to sizel=l 18 
and size2=24. 

The DCB subparameters for SYS1 .SAMPLIB have been changed to RECFM=F, LRECL=80, 
and BLKSIZE=80. 

During Stage II execution, an additional job step has been added to allow the IQADCMOO 
utility program to format the DSS paging system data set. 

The PFK (programmed-function-key) parameter of the SECONSLE macro instruction is 
also valid for the 3 1 5 8 . 

The SYS1 .DCMLIB data set is required if the programmed-function-key (PFK) command 
entry is specified in the SCHEDULR or SECONSLE macro instructions. 

There is a new component for VSAM (SYS1 .AOSAO) that has been added to the distri- 
bution library. This component is for planning purposes only and will not be useable 
until VSAM is released. 
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INTRODUCTION 



This chapter presents an overview of the system generation process and a discussion of the 
three types of system generation. Also in this chapter is a list and brief discussion of what to do 
after you have planned for your new System Control Program and received the starter system 
and/or distribution library tapes, but before the actual system generation. 



The System Generation Process 



System generation is a process that creates an OS/VS2 System Control Program tailored to 
both the data processing requirements and machine configuration of an installation. 

The System Control Program to be generated is specified with system generation macro instruc- 
tions that you code. During system generation, IBM-supplied components and user-written 
components are combined in a variety of ways to build a new System Control Program according 
to the specifications in the macro instructions (see Figure 1). The new VS2 System Control 
Program is composed of the standard programs incorporated into every System Control Pro- 
gram and optional programs selected from the distrubution libraries. 

A VS2 System Control Program is generated in two stages (see Figure 1). During Stage I, the 
macro instructions that you coded to describe the installation's machine configuration and the 
programming options you selected are assembled and analyzed for errors. If no errors are found, 
a job stream consisting of job control language and control statements is produced. During 
Stage n, these statements are used to select and process components from the distribution li- 
braries and from user-written routines from user-libraries to form the new VS2 System Control 
Program. 



Types of System Generation 



There are three types of system generation: a complete VS2 System Control Program (system) 
generation, a nucleus generation, and an I/O device generation. The type of generation is speci- 
fied in the GENERATE macro instruction. 

For a complete system generation, the job stream produced during Stage I is processed during 
Stage II to create an entirely new VS2 System Control Program. For a nucleus or I/O device 
generation, the job stream is used to modify an existing VS2 system. 



Complete System Generation 



This is the generation of a complete VS2 System Control Program. It is done when you are in- 
stalling a VS2 system for the first time or when you must create a new System Control Program. 



Nucleus Generation 



This is the generation of a new nucleus. It is done when changes need to be made to the nucleus 
of the System Control Program only. The program options and system configuration that are 
specified must be compatible with the unchanged part of the System Control Program. For a 
nucleus generation, the generating system can be the system that is being modified. In a nucleus 
generation, SYS1.LPALIB, SYS1. NUCLEUS, and SYS1.PARMLIB are the system data sets 
that are reconstructed. 
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Figure 1 . The system generation process. System generation macro instructions are assembled 
and expanded to form a job stream (Stage I). This job stream assembles, link-edits, 
and copies selected modules from the distribution libraries and user-supplied modules 
to the new system volumes to form the new system (Stage II). 



I/O Device Generation 



An I/O device generation is done when I/O devices or channels are to be added to or deleted 
from the existing system. In an I/O device generation, for example, you can add universal 
character set (UCS) support for the 1403 printer, change I/O device group names, change console 
specifications, or add or delete paging devices. You cannot add the programming support for 
telecommunications or graphics, or add additional access methods. For an I/O device generation, 
the system being modified cannot be the generating system. In an I/O device generation, 
SYS1.DCMLIB, SYS1.IMAGELIB, SYS1.LINKLIB, SYS1.LOGREC, SYS1.LPALIB, 
SYS 1. NUCLEUS, SYS1.PARMLIB, and SYS1.SVCLIB are the system data sets that are recon- 
structed. 
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Overview of System Generation Procedures 



This section briefly describes the sequence of procedures to be done before a system is gener- 
ated. The procedures are discussed in the order in which they should be done. For example, 
coding system generation macro instructions is presented before specifying the system data sets 
because, what is specified in the macro instructions helps to determine the specifications for the 
system data sets. All of the required coding should be done before execution of system gener- 
ation begins. 



Coding System Generation Macro Instructions 

After you have planned your new System Control Program, code the system generation macro 
instructions that specify the options you have selected. Some of the macro instructions are 
always required, some are required or optional, depending on the program options selected and 
the type of generation. 

Figure 6 lists all the macro instructions, shows whether they are required or optional, and gives 
the order in which they should be coded. The macro instructions are discussed alphabetically 
in "Specifying the New System Control Program." 

Allocating Space to the New System Data Sets and Cataloging Them 
in the System Catalog 

The system data sets should be considered next. If you are using the DATASET macro instruc- 
tion to allocate space to the system data sets and catalog them, you should refer to "Selecting 
the New System Data Sets" when you code the DATASET macros. This chapter describes 
each of the system data sets and tells whether they are required or optional. Also included is 
data definition (DD) information and cataloging information. The information presented in- 
cludes the default values that are used by the DATASET macro, but if you are using the 
IEHPROGM utility program, you must code this information. How to code the control state- 
ments and catalog statements for the IEHPROGM utility program is discussed with an example 
that may be helpful to refer to. 

If you are using IEHPROGM to initialize the system data sets, you would probably want to 
allocate space to the utility data set (OBJPDS), that is required for Stage II processing, at the 
same time. This information is found in the chapter "System Control Program Installation" in 
the section "Stage II Input." If you are using DATASET macros, you can code the IEHPROGM 
control statements for allocating space to OBJPDS when you code the job control language that 
is required for Stage I processing. 



Preparing to Execute System Generation 



The procedures discussed in the chapter "Preparing for System Generation" are done before 
system generation is executed. This chapter lists the procedures that need to be performed to 
make the generating system (the starter system or an existing VS2 system) and the distribu- 
tion libraries ready for execution. 



Executing System Generation 



The chapter "System Control Program Installation" discusses the actual execution of the Stage 
I and Stage II parts of system generation. Also given is the job control language required to 
execute Stage I and Stage II and the space requirements for the utility data sets required during 
Stage I and Stage II. 
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Restarting System Generation 



Coding errors or machine malfunctions may cause system generation to end unsuccessfully. 
The chapter "Restart Procedures" presents guidelines and coding examples for restarting 
system generation. 



Testing the New System 



After installing a VS2 System Control Program, you can test it by using the installation verifi- 
cation procedure (IVP). IVP is discussed in the chapter "Testing the System Control Program." 
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REQUIREMENTS FOR GENERATING A NEW SYSTEM 
CONTROL PROGRAM 

You can generate a VS2 system using either an existing VS2 system or a starter operating sys- 
tem that is provided by IBM. This chapter discusses the real-storage requirements for a system 
generation, the machine requirements for system generation using the starter system, and the 
programming requirements for system generation using either an existing VS2 system or a 
starter system. 

Real-Storage Requirements 

To generate a VS2 System Control Program using a starter system, 384K bytes of real storage 
is required. 

Machine Requirements 

VS2 system generation is performed using one of the following System/370 central processing 
units: 

Model 145 
Model 155II 
Model 158 
Model 165II 
Model 168 

Figure 2 shows the maximum machine configuration allowed for a VS2 system generation using 
the starter system. Any subset of this configuration can be used if it meets the minimum re- 
quirements shown in Figure 3. 

The I/O devices that are allowed for system generation when the starter system is used are 
listed in Figure 4. Like devices, such as direct-access devices, can be referred to by certain group 
names that support the IBM-supplied cataloged procedures. The group names that can be used 
are listed in Figure 5. (For additional information on group names, refer to the explanation of 
the UNITNAME macro instruction in "Specifying the New System Control Program.") 

Programming Requirements 

System generation is performed under the control of an existing system control program (the 
generating system) and is executed as any other job. The system that is used as the generating 
system is an existing VS2 System Control Program. If this is your first VS2 system generation, 
you must use a starter system that is provided by IBM as the generating system. The starter 
system contains all of the programs necessary to perform system generation. 

Using an Existing VS2 System as the Generating System 

For an existing VS2 system to be used as the generating system, it must contain a VS2 Re- 
lease 1 : 

OS/VS Assembler 
• Linkage editor 

IEBCOPY utility program 

Requirements for Generating a New System Control Program 5 



IEBEDIT utility program 
IEBPTPCH utility program 
IEBUPDTE utility program 
IEHDASDR utility program 
IEHLIST utility program 
IEHPROGM utility program 
IFCDIPOO program 
IFCEREPO service aid program 
IQADCMOO utility program 

These programs are defined in the glossary of this publication. 

Using the Starter System as the Generating System 

The starter system consists of: 

. A control program that supports the central processing unit(s) and I/O devices needed to 

perform the system generation 

• An assembler and a linkage editor 

• The utility programs used for data set space allocation, direct-access volume 
initialization, and for Stage II processing 

Before a starter system can be used as a generating system, certain procedures need to be per- 
formed to make the starter system operational. These procedures are described in the chapter 
"Preparing for System Generation." 
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Figure 2. Maximum machine configuration for using the starter system 
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Channel 

4 


System 
Console 


1 


3210/3215 
or 1052 


009, 01 F 




209, 21 F 






3066 


040, 060, 
0C0, 0D0, 
0E0.0F0 


140 


240 


340 




System 
Input 


1 


2540 
Reader 


OOC 




20C 






3505 
Reader 


012 










2400 
(7-track 
with data 
conversion) 




180, 181 


280, 281 


380, 381 


480,481 


2400 
(9-track) 




182, 183, 
184 


282, 283, 
284 


382, 383 


482, 483 


Punched 
Output 


1 


2540-2 
Punch 


00D 




20D 






3525 
Punch 


013 










2400 
(7-track 
with data 
conversion) 




180, 181 


280,281 


380,381 


480,481 


2400 
(9-track) 




182, 183, 
184 


282, 283, 
284 


382,383 


482, 483 


Printed 
Output 


1 


3211 


002, 004 










1403 


00E,00F 




20E 






2400 
(7-track 
with data 
conversion) 




180, 181 


280, 281 


380, 381 


480, 481 


2400 
(9-track) 




182, 183, 
184 


282, 283, 
284 


382, 383 


482, 483 


New 
System 


12 


2305-1 




1F0 


2F0 






2305-2 




1D0 


2 DO 






2314 (or 
2319 on 
channel 1) 




130,131, 
132,133, 
134, 135 


230,231, 
232,233, 
234, 235 


330,331, 
332, 333 




3330 




150,151, 
152, 153 


250, 251 , 
252,253 


350,351, 
352, 353 




Select the minimum requirement from the list of devices given in each section. For example, the one device needed to contain the 
new system can be either a 2305-1 , 2305-2, 2314/2319, or 3330. 

2 

The three utility data sets required for Stage I and the object-module data set required for Stage II do not require an additional 

direct-access device if you are using 3330's. If you are using 2314s/2319s, an additional direct-access device is required. 



Figure 3 (Part 1 of 2). Minimum I/O device requirements for performing a system generation using a starter system 
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Use 


Minimum 

1 
Requirement 


Device 
(choose one) 


Unit Address (choose one) 


Multiplexor 
Channel 


Selector 

Channel 

1 


Selector 

Channel 

2 


Selector 

Channel 

3 


Selector 

Channel 

4 


Starter 
System and 
Distribution 
Libraries 


2 


2314 (or 
2319 on 
channel 1) 




130,131, 
132,133, 
134,135 


230,231, 
232, 233, 
234, 235 


330,331, 
332, 333 




3330 




150,151, 
152,153 


250,251, 
252, 253 


350,351, 
352, 353 




Four 
Utility 
Data Sets 2 


1 


2305-1 




1F0 


2F0 






2305-2 




1D0 


2D0 






2314 (or 
2319 on 
channel 1) 




130,131, 
132,133, 
134,135 


230,231, 
232, 233, 
234,235 


330,331, 
332,333 




3330 




150,151 
152,153 


250,251, 
252, 253 


350,351, 
352, 353 




Select the minimum requirement from the list of devices given in each section. For example, the one device needed to contain the 
new system can be either a 2305-1 , 2305-2, 2314/2319, or 3330. 

The three utility data sets required for Stage I and the object-module data set required for Stage II do not require an additional 
direct -access device if you are using 3330's. If you are using 2314s/2319s, an additional direct-access device is required. 



Figure 3 (Part 2 of 2). Minimum I/O device requirements for performing a system generation using a starter system 



1 
Magnetic Tape Drives 




2400 


2400 series 9-track magnetic tape drive 


2400-2 


2400 series 7-track magnetic tape drive with data conversion 


Direct-Access Devices 




2305-1 


2305 fixed head disk storage model 1 


2305-2 


2305 fixed head disk storage model 2 


2314 


231 4 disk storage facility 


2319 


2319 disk storage facility 


3330 


3330 disk storage drive 


Unit Record Devices 




1052 


1052 console keyboard 


1403 


1403 printer 


2540 


2540 reader punch (read feed) 


2540-2 


2540 reader punch (punch feed) 


3066 


3066 system console 


3210 


3210 console printer keyboard 


3211 


3211 printer 


3215 


3215 console printer keyboard 


3505 


3505 card reader 


3525 


3525 card punch 


The 3400 magnetic tape series 


is functionally equivalent to the 2400 series. The 3400 series may be used for system generation, but 


you must specify a 2400 series 


device type. 



Figure 4* I/O devices that can be used for system generation using the starter system 
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Group 
Name 


Devices identified by group name 


SYSSQ 


Sequential-access devices at any of the followi 


ng addresses: 










2400 series 2305-1 2305-2 


2314/2319 




3330 






180 280 380 480 1F0 1D0 


130 230 330 


150 


250 


350 




181 281 381 481 2F0 2D0 


131 231 331 


151 


251 


351 




182 282 382 482 


132 232 332 


152 


252 


352 




183 283 383 483 


133 233 333 


153 


253 


353 




184 284 


134 234 

135 235 








SYS DA 


Direct-access devices at any of the following addresses: 










2305-1 2305-2 


2314/2319 




3330 






1 F0 1 DO 


130 230 330 


150 


250 


350 




2F0 2D0 


131 231 331 


151 


251 


351 






132 232 332 


152 


252 


352 






133 233 333 


153 


253 


353 






134 234 












135 235 









Figure 5. Group names that can be used to identify I/O devices during system generation 
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SPECIFYING THE NEW SYSTEM CONTROL PROGRAM 

This chapter contains the detailed information you need to select and code the system genera- 
tion macro instructions. Included in this chapter are: 

. An explanation of the conventions used in this book to show the macro instructions. 

. A summary of the macro instructions by group (machine configuration, control program, 
etc.) and type of generation. 

• An alphabetic listing of the macro instructions. In this section, the function of each 
macro instruction, the format, a description of the parameters and their defaults, and a 
coding example is given. 

Coding System Generation Macro Instructions 

This section describes the rules used to code system generation macro instructions and the 
notation used in this book to describe the system generation macro instructions. 

Rules for Coding System Generation Macro Instructions 

The rules for coding system generation macro instructions are those of the assembler language. 
The following paragraphs are a summary of these rules as stated in OS/VS and DOS/ VS 
Assembler Language. 

System generation macro instructions have the following standard format: 



Name 


Operation 


Operand 


Symbolic 
name 


Macro instruction 
name 


Optional and required parameters 



Name symbolically identifies the macro instruction. If included, it can contain from one 
through eight alphameric characters, the first of which must be alphabetic. The name must 
begin in the first position of the macro instruction and must be followed by one or more blanks. 
Except where otherwise indicated in the description of the individual macro instructions, the 
name field of a system generation macro instruction is ignored during system generation. 

Operation identifies the macro instruction. It must be preceded and followed by one or more 
blanks. 

Operand contains parameters coded in any order and separated by commas. The operand 
field ends with one or more blanks placed after the last parameter. In most system generation 
macro instructions, keyword parameters are used in the operand field. A parameter consists 
of a keyword followed by an equal sign (=) and the keyword value. The keyword value may 
be a single value or a list of values. If it is a list of values, the values must be separated by com- 
mas and the list must be enclosed in parentheses. 

Comments can be written in a system generation macro instruction, but they must be separated 
from the last parameter of the operand field by one or more blanks. You can use an entire 
card for a comment by placing an asterisk in the first column of each card. A macro instruc- 
tion that has no parameters cannot have comments. 

System generation macro instructions are coded in columns 1 through 71 of a card. You can 
continue a macro instruction that exceeds 7 1 columns onto one or more additional cards by 
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placing a nonblank character in column 72 to indicate continuation. The system generation 
macro instruction can be interrupted either at column 71 or after any comma that separates 
parameters. The continued portion must begin in column 16 of the following card. Comments 
may appear on every card of a continued statement. Columns 73 through 80 can be used to 
code identification and/or statement sequence characters if you choose. 



Describing System Generation Macro Instructions 



This section lists the conventions used in this publication to illustrate the format and coding 
of system generation macro instructions: 

. Letters in boldtype, numbers, and punctuation marks must be coded exactly as shown. 
Exceptions to this convention are brackets, [ ] ; braces, j \ ; ellipses, . . . ; and 
subscripts, which are never coded. 

. Lowercase letters in italics represent variables for which you must substitute specific 
information or specific values. 

. Items or groups of items within brackets are optional. They may be omitted at your 

discretion. Conversely, the lack of brackets indicates that an item or group of items must 
be coded. 

. Stacked items enclosed in braces represent alternative items. Exactly one of the stacked 
items should be coded. 

. If an alternative item is underlined, it is the default value - the operating system will 
automatically assume it is your choice if none of the items is coded. 

• An ellipsis indicates that the preceding item or group of items can be coded two or more 
times in succession. 

A typical system generation macro instruction might appear as: 



CHANl CHANNEL ADDRESS=1 / TYPE=SELECTOR 



In this example, CHANl, in the name field, symbolically identifies the macro instruction. 
CHANNEL, in the operation field, identifies the macro instruction to the system. ADDRESS 
is a required parameter and is coded in the operand field. It is followed by an equal sign and 
the selected value for the parameter. This value is followed by a comma separating the 
ADDRESS parameter and value from the next parameter. The TYPE parameter is also required 
for this macro instruction and is coded in the same way as the ADDRESS parameter. Since no 
parameters follow the TYPE parameter, it is not followed by a comma but by a blank indicat- 
ing that it is the last parameter in the operand field for this macro instruction. 



Macro Instruction Summary 



Not all system generation macro instructions are required for every system generation. Figure 6 
lists the system generation macro instructions for each type of system generation, indicating 
whether they are required or optional. If neither required nor optional is indicated, that macro 
instruction does not apply to that type of system generation. If it is included in the input deck 
it Is ignored, unless it contains a coding error. 

Figure 6 also shows which macro instructions can be issued more than once during a system 
generation. All UNITNAME macro instructions having the same value in the NAME param- 
eter must appear together in the input deck. The GENERATE macro instruction must be the 
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last macro instruction in the input deck for system generation. All other system generation 
macro instructions can be issued in any order. 

Dependencies among the parameters of a macro instruction are illustrated by the macro in- 
struction format and, in some cases, by tables within the macro instruction description. 
Dependencies between macro instructions are stated in the descriptions of each macro instruc- 
tion. 



Group 


Macro 
Instruction 


Complete 


Nucleus 


I/O Device 


Machine 
Configuration 


CENPROCS 

CHANNEL 1 

IODEVICE 1 

UCS 

UNITNAME 1 


required 
required 
required 
optional 
required 


required 
required 
required 


required 
required 
required 
optional 
required 


Control 
Program 


CKPTREST 

CTRLPROG 

EDIT 

EDITOR 

LOADER 

MACLIB 

PAGE 1 

SCHEDULR 

SECONSLEl 

TSO 


optional 
optional 
optional 
optional 
optional 
optional 
required 
required 
optional 
optional 


optional 

required 
required 
optional 2 
optional 2 


optional 

required 
required 
optional 2 
optional 2 


Data 
Management 


DATAMGT 
GRAPHICS 


optional 
optional 


optional 2 
optional 2 


optional 2 
optional 2 


User-written 
Routines 


LINKLIB 
LPALIB 
RESMODS 
SVCTABLE 1 


optional 
optional 
optional 
optional 


optional 2 
optional 2 
optional 2 
optional 2 


optional 2 
optional 2 


Generation 


DATASET 1 . 3 
GENERATE 


optional 
required 


optional 
required 


optional 
required 


1 
This macro instruction can be used more than once in the input deck. 

2 
This macro instruction is required if it was originally specified in the last complete system 

generation. 

*n"his macro instruction is required under certain conditions. Refer to the DATASET macro instruc- 
tion text in this chapter. 



Figure 6. The required and optional system generation macro instructions and the order in 
which they should be considered 
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CENPROCS 

Required for: 
complete 
nucleus 
I/O device 

The CENPROCS macro instruction describes the central processing unit (CPU) and secondary 
CPU support for the new system. Recovery management support (RMS) is included for all 
CPU models specified. (For information on RMS, refer to OS/VS Recovery Management 
Support Logic.) 

For a nucleus or I/O device generation, the CENPROCS macro instruction must be coded with 
the same parameters and subparameters that were specified in the last complete system 
generation. 



CENPROCS MODEL= ( 145R \ 

1 1 55R / 
\ 158R > 
I 165R I 
V168R/ 

[SECMODS= fALL 

( (model [ ,model] 



Parameter 
MODEL= model 

SECMODS= 



Subparameter Explanation 

specifies the model number of the central processing unit. 

specifies the additional System/370 models for which environ- 
ment record editing and printing (EREP) support will be 
included in the new system. If this parameter is omitted, no 
secondary models will be supported. 



ALL 

model 



specifies that all supported CPU models are to be included, 
specifies the additional CPU models to be supported. 



Example: This example specifies a model 145 central processing unit and additional support 
to model 15 511. 



CPU 



CENPROCS 



MODEL=14 5R,SECMODS=(155R) 
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CHANNEL 

Required for: 
complete 
nucleus 
I/O device 

The CHANNEL macro instruction describes the channel characteristics. There must be a 
CHANNEL macro instruction for each channel type in your computing system. 

For a nucleus generation, the CHANNEL macro instructions must be coded with the same 
parameters and subparameters that were used in the last complete system generation. 

For an I/O device generation, each channel must be respecified. Channels can be deleted or 
added, but each channel in the new system must be specified. 

If you do not specify a name in the name field of this macro instruction, a sequential identifi- 
cation number is supplied by the macro. The order in which the numbers are assigned is deter- 
mined by the order in which they appear in the input stream. For example, if the name is 
omitted from the third CHANNEL macro instruction, the name CHAN #3 is supplied in each 
diagnostic message resulting from an error detected during processing of that macro instruction. 



CHANNEL ADDRESS= (address [jddress] . . .) 

TYPE=(BLKMPXR \ 

I HISPEEDMPXR / 
j MULTIPLEXOR) 
V SELECTOR ) 



Parameter 
ADDRESS= 



TYPE= 



Subparameter 

address 



BLKMPXR 



HISPEEDMPXR 



MULTIPLEXOR 



Explanation 

specifies the address assigned to the channel. The 
value must be alphameric, through 9 or A through F. 
Multiple addresses may be specified for the channels 
having the same value for the TYPE parameter. 

specifies the type of channel defined by this macro 
instruction. 

The channel is a block multiplexor channel that is 
integrated either with a central processing unit or 
with a 2880 channel frame. An address must be 
specified for each block multiplexor channel. 

The channel is a 2870 channel frame and there are one 
or more subselector channels on the 2870. You can- 
not use separate CHANNEL macro instructions or 
specify different addresses for the subselector 
channels. 

The channel is a byte multiplexor channel integrated 
with either the central processing unit or a 2870 
channel frame (if there are no sub-selector channels 
on the 2870). 
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Parameter Subparameter Explanation 

TYPE= SELECTOR The channel is a selector channel integrated with 

(Continued) either the central processing unit or a 2860 channel 

frame. An address must be specified for each selector 

channel. 

Example: This macro specifies that channels 1,2, and 3 are selector channels. 

CHANl-3 CHANNEL ADDRESS= (1 , 2 , 3) ,TYPE=SELECTOR 
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CKPTREST 

Optional for: 

complete 

Not applicable for: 

nucleus 

I/O device 

The CKPTREST macro instruction is used to specify the standard ABEND codes that you do 
not want eligible for automatic restart, and those codes written by you that you do want 
eligible for automatic restart. If this macro instruction is omitted, the standard set of ABEND 
codes will be included in the new system. 

For information on checkpoint/ restart, refer to OS/VS Checkpoint/Restart. For information 
on ABEND codes, refer to OS/VS Message Library: VS2 System Codes. 



CKPTREST [ELIGBLE=(cocte [,code] . . .)] 

[NOTELIG=(coc/e[ / coafe] . . .)] 



Parameter Subparameter Explanation 

ELIGBLE= code specifies ABEND codes written by you which you 

want eligible for automatic restart. The code speci- 
fied is a decimal integer from to 4095. 

A maximum of ten values may be specified 

NOTELIG= code specifies those standard ABEND codes which you do 

not want to be eligible for automatic restart. 

The standard ABEND codes are listed in OS/VS 
Checkpoin t/ Restart. 

Example: This example specifies the standard ABEND codes that are not to be recognized 
for automatic restart. 



CKPTRST 



CKPTREST 



NOTELIG= (001,100,031,113) 
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CTRLPROG 
Optional for: 
complete 
nucleus 
I/O device 

The CTRLPROG macro instruction is used to specify control program options. If it is not 
specified, the default values are used. 

For a nucleus generation, the values that were specified in the DEBTINC, DEBTSZE, REAL, 
TRACE, and TZ parameters can be changed. The value specified for the QSPACE parameter 
can be changed, but this parameter cannot be included if it was not specified in the last com- 
plete system generation. A fixed BLDL table can be included in or deleted from the system 
during a nucleus generation. 

For an I/O device generation, the value specified in the MAXIO parameter can be changed. All 
other parameters must be specified as they were in the last complete system generation. 

For additional information about control program options, refer to OS/VS2 Planning and Use 
Guide. To estimate storage for control program options, refer to OS/VS2 Storage Estimates. 



CTRLPROG [ ASCI 1= ( EXCLUDE) ] 

(INCLUDE f 

[ APG= (priority, lower bound, upper bound, delta, statistics interval, 
ratio)] 1 

[DEBTINC= (size)] 
\80 ( 

[DEBTSZE= (size) ] 



(size) 



[ LSQAC E L= ( (cellsize-number) 

[,{cellsize-number)] ...)] 1 

[MAXIO= number] 

[OPTIONS= (value [,value] . . .) I 1 

[PGCLEAR=fYES)l 
W / 
IQSPACE= 

[REAL= 



isizeX] 1 
U J 



[SQACEL= ( (cellsize-number) 

[, (cellsize-number)] . . . )] * 

[TMSLICE= (priority, SLC-timel priority, SLC-time] ...)] 1 

[TRACE= (number) I 1 

[7Z=(i\N),hh[/nm])] 



The values specified in these parameters will become members of the IEASYSOO parameter list in 
SYS1.PARMLIB. 
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Parameter Subparameter 

ASCII= 



EXCLUDE 



INCLUDE 



APG= 



priority 



lower bound 



upper bound 



delta 



statistics interval 



ratio 



DEBTINC= size 

80 



DEBTSZE= size 

80 



Explanation 

specifies the inclusion or exclusion of the ASCII trans- 
lation routine. If you plan to use ASCII utilities, this 
parameter must be specified. If this parameter is not 
specified, EXCLUDE will be assumed. 

specifies that the routine will not be included. 

specifies that the routine will be included as part of the 
pageable supervisor. 

specifies a single priority level to a group of tasks in an 
attempt to provide optimum use of CPU and I/O re- 
sources by these tasks. 

If APG (automatic priority group) is specified, all sub- 
parameters must be coded. For information on APG, 
refer to OS/VS2 Planning and Use Guide. 

is a decimal number from to 13 that represents the 
scheduling priority that is to be identified as the auto- 
matic priority group. 

is a decimal number from 1 to 999 that represents, in 
milliseconds, the lower bound of a time-slice that may 
be given to an APG task. 

is a decimal number from 2 to 999 that represents, in 
milliseconds, the upper bound of a time-slice that may 
be given to an APG task. This value must be greater 
than the value specified for the lower bound. 

is a decimal number from 1 to 99 that represents, in 
milliseconds, the delta to be added to or subtracted 
from the APG time-slice value at the end of each 
statistics interval. 

is a decimal number from 1 to 9999 that represents, 
in milliseconds, the length of the statistics interval. 

is a decimal number from 1 to 9 that represents, in 
tenths, the ratio of time-slice ends to the sum of 
voluntary waits plus time-slice ends in the APG. 

is a decimal number from 8 to 32752 that specifies by 
how much the data extent block (DEB) table for DEB 
validity checking will be expanded if the initial size is 
insufficient for a jobstep. If this parameter is not 
specified, the default value is assumed. 

is a decimal number from 8 to 32760 that specifies the 
initial size, in bytes, of the DEB table for DEB validity 
checking. If this parameter is not specified, the default 
value is assumed. 
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CTRLPROG 



Parameter Subparameter 

LSQACEL= 



cell size 



number 



MAXIO number 



OPTIONS= 



BLDL 



DEVSTAT 



RER 



Explanation 

specifies the size and number of cells in the local 
system queue area. If this parameter is not specified, 
no local SQA cells will be available. 

is a decimal number from 8 to 256 (bytes) that 
specifies the size of the cell in the local system queue 
area. The value must be specified in even multiples 
of 8 bytes. If it is not, the value specified will be 
rounded upward to an even multiple of 8 bytes. 

is a decimal number from 1 to 8 that specifies the 
number of cells. 

The total size of the LSQA area is limited to 4K 
(4096 bytes). If 4K is exceeded, the cells will be 
truncated starting with the largest cell. Storage re- 
quirements for the local system queue area can be 
found in OS/VS2 Storage Estimates, 

specifies the maximum number of I/O operations that 
can be simultaneously processed by the new VS2 sys- 
tem. This number is the sum of those I/O operations 
that are being executed simultaneously and those that 
are currently queued but are not being executed. The 
number specified determines the number of request 
queue elements (RQEs) in the nucleus. 

If this parameter is not specified, the default value is 
one RQE for each I/O device when the total number 
of devices is 50 or less. Beyond 50, one RQE will be 
assigned for every device other than direct-access. One 
RQE will be assigned for every four direct-access 
devices in the new system. 

specifies which of the following control program op- 
tions are to be included in, or excluded from, the new 
VS2 system. If this parameter is not specified, none 
of these options will be included in the system. 

specifies a fixed BLDL table. If this option is not 
specified, the BLDL table will be pageable. 

specifies inclusion of the nucleus initialization (NIP) 
support that will regard all direct-access devices and 
magnetic tape drives that are not in a ready condition 
or that are not currently attached to the system as 
offline. 

specifies that the reduced error recovery procedure 
for magnetic tape will be used if requested in the 
OPTCD parameter of a DD statement or a DCB macro 
instruction. If RER is not specified, all requests for 
reduced error recovery will be ignored. 
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Parameter 


Subparameter 


OPTIONS= 

(Continued) 


RDE 


PGCLEAR= 






YES 




NO 


QSPACE= 


size 
1 



REAL= 



size 




SQACEL= 



cell size 



number 



TMSLICE= 



priority 



Explanation 

specifies inclusion of the reliability data extractor fea- 
ture. For information about RDE, refer to OS/VS 
SYS1. LOGREC Error Recording. 

specifies whether or not a page frame in real storage 
will be cleared to zeros before the first page is paged 
into that area. 

specifies that the area will be cleared to zeros. 

specifies that the area will not be cleared to zeros. 

is a decimal number that specifies the number of 64K- 
byte segments reserved for system queue space. If 
this parameter is not specified, a value of 1 is used. 
OS/VS2 Storage Estimates tells how to estimate the 
storage required by the system queue space. 

is a value from to 999 that specifies the amount of 
real storage available, in addition to the amount of 
real storage that is provided by the system. The value 
specified is the number of 4K (4096 bytes) blocks. 
The value is expressed as a decimal number without 
the K. A minimum value of 16 is assumed by the 
system. Refer to OS/VS2 Storage Estimates for 
information on determining this value. 

specifies the size and number of cells in the system 
queue area. If this parameter is not specified, no SQA 
cells will be available. 

is a decimal number from 8 to 256 (bytes) that speci- 
fies the size of a cell in the system queue area. The 
value must be specified in even multiples of 8 bytes. 
If it is not, the value specified will be rounded 
upward to an even multiple of 8 bytes. 

is a decimal number from 1 to 8 that specifies the 
number of cells. 

The total size of the system queue area (SQA) cells is 
limited to 4K (4096 bytes). If 4K is exceeded, the 
area will be truncated to this size. 

To estimate the size and number of SQA cells, refer to 
OS/VS2 Storage Estimates. 

specifies time-slicing for the jobs scheduled to be 
executed that have a given priority number. Upper- 
case letters and hyphens are coded as shown. 

is a decimal number from to 13 that specifies the 
priority number of the jobs to be time-sliced. 
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Parameter 

TMSLICE= 
(Continued) 



Subparameter 

SLC-time 
(Continued) 



TRACE= 



number 




TZ= 



ff} 



hh 



mm 



CTRLPROG 

Explanation 

is a decimal number from 20 to 9999 that specifies 
the maximum number of milliseconds for which each 
ready job of the priority specified is to have control 
of the CPU during one cycle through the group. 

If this parameter is not specified, no jobs will be time- 
sliced. Time-slicing can be added to or deleted from 
the system during a nucleus generation. 

For information on time-slicing, refer to OS/VS2 
Planning and Use Guide and OS/VS2 Storage 
Estimates. 

specifies the number of system trace table entries to be 
maintained. If this parameter is not specified, a value 
of Ois assumed. 

A tracing routine aids in debugging and maintenance 
by storing in the trace table information pertaining to 
start I/O (SIO) instructions, supervisor (SVC) interrup- 
tions, dispatcher interruptions, and I/O interruptions. 
When the table is full, the succeeding entries overlay 
the existing ones. 

During system generation, only the size of the table 
is specified. However, when this parameter is specified, 
the trace program routines are also included as part of 
the control program. Additional information is found 
in OS/VS2 Planning and Use Guide and OS/VS2 
Storage Estimates. 

specifies that local standard time will be reflected in 
the output instead of Greenwich Mean Time. 

specifies whether the time zone is west or east of the 
Greenwich Meridian. 

specifies the number of hours difference between local 
time and Greenwich Mean Time. The hh is specified 
as either one or two decimal digits from to 12. 

specifies the number of minutes to be added to the hh 
subparameter to obtain a time zone offset from 
Greenwich Mean Time in hours and minutes. The mm 
is specified as one or two decimal digits between and 
60. If mm is omitted, is used. 

If the TZ parameter is not specified, Greenwich Mean 
Time will be produced. 
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Example: The example specifies the options for the control program for the new system. A 
fixed BLDL table has been specified, inclusion of nucleus initialization support (NIP) to treat 
direct-access devices and magnetic tape devices that are in a not-ready condition as off-line, and 
inclusion of the reliability data extractor feature (RDE) has also been specified. Six 64K-byte 
segments have been reserved for system queue space, 8 SQA quickcells of 256 bytes have been 
reserved, and 8 LSQA quickcells of 256 bytes have been reserved. Twenty additional 4K blocks 
of real storage have been specified for jobs that run in a VIRTU AL=REAL region. The maximum 
length of time that a job in priority -class 13 will have control is 500 milliseconds. Up to 100 
simultaneous I/O requests will be processed. Local standard time will be used with an 8-hour 
deviation from Greenwich Mean Time. The automatic priority group (APG) for the dispatcher 
is specified as follows: scheduling priority — 12, time-slice lower bound — 20, time-slice upper 
bound — 500, time-slice delta — 1, statistics interval — 15, time-slice and wait ratio — 5. De- 
fault values are assumed for the ASCII translation routine, the system trace table, and the data 
extent block (DEB) table size and increment. 

CTRLPROG CTRLPROG OPTIONS= (BLDL, DEVSTAT , RDE) , X 

QSPACE=6,SQACEL= (256-8) , X 

LSQACEL= (256-8) ,REAL=20, X 

TMSLICE=(13 / SLC-500) ,MAXIO=100, X 
TZ=(W,8) ,APG=(12,20,500,1,15,5) 
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DATAMGT 

Optional for: 
complete 
nucleus 
I/O device 

The DATAMGT macro instruction is used to specify the optional access methods to be in- 
cluded in the new system. This macro instruction is optional. 

A telecommunications option can be included in the system so that tasks can use the basic tele- 
communications access method (BTAM) or the telecommunications access method (TCAM). 
Also, the indexed sequential access method (ISAM) can be included in the new system so that 
tasks can use the basic indexed sequential access method (BISAM) or the queued indexed 
sequential access method (QISAM). Additional information can be found in: 

OS/VS Data Management Services Guide 

OS/VS2 Storage Estimates 

OS/VS BTAM 

OS TCAM Concepts and Facilities 

The following standard access methods are always included in the system: 
BDAM — basic direct access method 
BPAM — basic partitioned access method 
BSAM — basic sequential access method 
QSAM — queued sequential access method 

For a nucleus generation, if this macro instruction was used during the last complete system 
generation, it must be respecified. The same parameter and subparameters must be coded. 

For an I/O device generation, if this macro instruction was used during the last complete 
system generation, it must be respecified. The same parameters and subparameters must be 
coded. If this macro instruction was not specified during the last complete system generation, 
it cannot be specified for this type of generation. 

DATAMGT ACSMETH= {method [, method] ...) 



Parameter Subparameter Explanation 

ACSMETH= method specifies one or more of the following access methods: 

BTAM — basic telecommunication access method 
TCAM — telecommunications access method 
ISAM — basic and queued indexed sequential 
access methods 

If the TSO macro is specified, TCAM is assumed. 
Example: This example specifies that ISAM is to be included in the new system. 
DATAMGT DATAMGT ACSMETH= (ISAM) 
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DATASET 

Optional for: 
complete 
nucleus 
I/O device 

The DATASET macro instruction is used to allocate space to the new system data sets and 
catalog them in the system catalog. (See "Allocating Space to the New System Data Sets and 
Cataloging Them in the System Catalog" in the chapter "Selecting the New System Data Sets.") 
All of the system data sets that are specified using the DATASET macro are cataloged except 
SYSCTLG, which contains the system catalog. 

If you use the DATASET macro, it must be specified for each system data set that is to be 
included in the system. If you do not use the DATASET macro, you must use the IEHPROGM 
utility program. Space allocation and cataloging of system data sets must take place before 
Stage II. (For information on IEHPROGM, see "Preparation for System Generation.") 

A DATASET macro must be specified for any system data set used during system generation 
that is not on the system residence volume, even if the data set has already had space allocated 
to it and has been cataloged. Omission of the SPACE parameter in the DATASET macro will 
prevent the allocation of space for a system data set. 

For a complete generation, the SPACE parameter must be specified. 

For z nucleus generation, if SYS1.LINKLIB, and/or SYSl.LPALIB,or SYS1.PARMLIB are not 
on the system residence volume, you must respecify the DATASET macro(s). The SPACE 
parameter need not be respecified. If it is respecified, it will be ignored. 

For an I/O device generation, if SYS1 .DCMLIB, and/or SYS1 .IMAGELIB, SYS1 . LINKLIB, 
or SYS1 .PARMLIB are not on the system residence volume, you must respecify the 
DATASET macro (s). The SPACE parameter need not be respecified. If it is respecified, it 
will be ignored. 

In both nucleus and I/O device generations, all SPACE parameters are ignored. Therefore, 
you need not remove them from the input deck or change them. 

The DATASET macro instructions use the default values for the DCB parameters that are 
required by the system data sets. You cannot specify DCB information for the system data 
sets if you are using the DATASET macro instructions. For information on the default 
values for the DCB parameters, refer to "Selecting the New System Data Sets." 



DATASET system data set 



(CYL | 

[SPACE= ( < TR K > .quantity)] 

\blocksize ) 

[VOL= ( {serial, type \)\ 
(SYSRES,2314f 
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Parameter Subparameter Explanation 

system data specifies the system data set for which space is to be 

set allocated. The system data set to be allocated may be: 



BRODCAST 

CMDLIB 

DCMLIB 

DSSVM 

DUMP 

HELP 

IMAGELIB 

LINKLIB 

LPALIB 

MACLIB 

MANX 

MANY 

NUCLEUS 

PARMLIB 

PROCLIB 

SAMPLIB 

SVCLIB 

SYSCTLG 

SYSJOBQE 

SYSVLOGX 

SYSVLOGY 

TELCMLIB 

UADS 

The following system data sets must reside on the sys- 
tem residence volume: 

LOGREC 1 
NUCLEUS 
SVCLIB 
SYSCTLG 

The following system data sets must exist during sys- 
tem generation and if they are not specified will be 
assumed to reside on the volume specified in the 
RES VOL parameter of the GENERATE macro instruc- 
tion (system residence volume): 

DSSVM 

LINKLIB 

LPALIB 

MACLIB 

NUCLEUS 

PARMLIB 

PROCLIB 

SAMPLIB 

SVCLIB 

SYSCTLG 



Space for LOGREC is allocated by the generating system. More explanation is given in the chapter 
"Selecting the New System Data Sets" under "SYS1. LOGREC." 
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DATASET 



Parameter 

system data 
set (Continued) 



Subparameter 



SPACE= 



( CYL I 
<JTRK 

(blocksize, 
quantity 



Explanation 

IMAGELIB must exist in the system to be generated 
if the UCS macro instruction is specified. 

TELCMLIB must exist in the system to be generated 
if BTAM or TCAM is specified in the DATAMGT 
macro instruction. 

If you are generating a system with TSO, CMDLIB 
must have space allocated to it and it must be cataloged. 
If HELP and/or UADS is to be included in the system, 
you must specify a DATASET macro for them even 
if the data sets are preallocated. 

specifies a request that space allocation be based 
solely on the values given in this subparameter. 

specifies the unit of space to be allocated. Space can 
be allocated in cylinders, tracks, or average block 
length. 

specifies how many units of space (cylinders, tracks, 
or blocks) are to be allocated. Depending on the sys- 
tem data set, the quantity may have one of several 
forms. Generally the form is: 

(primary quantity [, secondary quantity] [, directory 
blocks] ) 

primary quantity 

specifies how many units of space (tracks, cylinders, 
or blocks) are to be allocated. 

secondary quantity 

specifies how many more tracks or cylinders are to 
be allocated if additional space is required, or how 
many more blocks of data may be included if addi- 
tional space is required for the data set. Secondary 
quantity space allocation is valid for the following 
system data sets: 

CMDLIB 

HELP 

LINKLIB 

LPALIB 

MACLIB 

PROCLIB 

SAMPLIB 

SVCLIB 

SYSCTLG 

TELCMLIB 

UADS 
directory blocks 

specifies the number of 256-byte blocks to be 
allocated for the directory of a partitioned data 
set. Directory block information must be specified 
for the following system data sets if space is being 
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Parameter Subparameter 

SPACE= quantity 

(Continued) (Continued) 



VOL= 



serial 

number 

SYSRES 

device type 
2314 



Explanation 

allocated for them by means of DATASET macro 
instructions: 

CMDLIB 

DCMLIB 

HELP 

IMAGELIB 

LINKLIB 

LPALIB 

MACLIB 

NUCLEUS 

PARMLIB 

PROCLIB 

SAMPLIB 

SVCLIB 

TELCMLIB 

UADS 

The amount of space for the system data set 
SYS1.LOGREC is always calculated and allocated by 
the generating system on the system residence volume 
of the system being generated. This applies to com- 
plete and I/O device generations. 

If the DATASET macro is used to allocate space to 
SYS1 .DSSVM, the following must be specified in 
the SPACE parameter: 

SPACE=(2048,(600)) 

Estimates for space allocation for the system data sets 
is in OS/VS2 Storage Estimates. 

specifies the volume serial number and the device type 
of the volume for the system data set. 

specifies the volume serial number. SYSRES is the 
default value unless the RESVOL parameter in the 
GENERATE macro specifies another value. 

specifies the device type of the volume. The device 
types that may be coded are: 2305-1 , 2305-2, 2314, 
and 3330. 

The VOL parameter works in conjunction with the 
RESVOL parameter in the GENERATE macro. The 
default value for RESVOL is the same as that for 
VOL. If RESVOL is changed, the default value for 
VOL becomes the changed value. 

If either serial number or device type is specified, both 
must be specified. If this parameter is not specified, 
SYSRES, 2314 is used. 
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DATASET 

Example: This example catalogs and allocates space to the SYS1 .NUCLEUS system data set. 
Two cylinders are required with no secondary space allocation and two 256-byte blocks are 
requested for the directory. 

NUCLEUS DATASET NUCLEUS , SPACE= (CYL , ( 2 , , 2 ) ) 
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EDIT 

Optional for: 
complete 

Not applicable for: 

nucleus 

I/O device 

The EDIT macro instruction specifies the physical characteristics and processing attributes of 
the data sets to be processed by the TSO EDIT command. Three programs may be specified 
for each data set type: an exit routine for processing user-defined information during the 
EDIT command initialization, a syntax checker, and a routine that processes the EDIT data 
set when the RUN subcommand of EDIT is issued. This macro instruction is optional for a 
complete system generation of a system with TSO. 



EDIT BLOCK= ([n],[n] , . . .) 

CHECKER- ( [name] , [name] ,...) 

{CAPS ) 

ASIS >,...) 

capsonly) 

DSTYPE= {name[,name] . . .) 
FIXED= ([d-m],[d-m] , . . .) 
(FIXED ) 

format=kvar /,...) 
(fxdonly) 

PRMPTR= ( [name] , [name] , . . .) 

USEREXT= ([name] , [name] ,...) 

USERSRC= ( ( DATASET ),...) 
(INCORE f 

V AR= ([d-m] ,[d-m] , . . .) 



Commas are required to denote missing operands in all parameters except DSTYPE. Defaults 
for omitted operands are listed in Figure 7. 

Parameter Subparameter Explanation 

BLOCK= n specifies, in bytes, the default length of blocks for 

the data sets created by the TSO EDIT command. 

The n is an integer from 1 to 32760 that specifies the 
default blocksize for any data set of the type speci- 
fied in the corresponding name field of the DSTYPE 
parameter. 

CHECKER= name specifies the installation-supplied processor that is to 

be used by the TSO EDIT command to check lines in 
the data set for proper syntax. 
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Parameter 

CHECKER= 

(Continued) 



CONVERT= 



Subparameter 

name 
(Continued) 



CAPS 



ASIS 



CAPSONLY 



DSTYPE= name 



FIXED= 



d-m 



Explanation 

The name is the 1 to 8 character module name that 
the TSO EDIT command will use to invoke the 
CHECKER for data sets of the type specified by the 
corresponding name field in the DSTYPE parameters. 

specifies whether input data to the TSO EDIT com- 
mand should be converted to upper case. 

specifies that the CAPS operand on the TSO EDIT 
command, which requests upper case conversion of 
data, is to be the default for data sets of the type 
specified by the corresponding name field of the 
DSTYPE parameter. 

specifies that the ASIS operand on the TSO EDIT 
command, which requests that the data remain as 
entered (for example, upper and lower case), is to be 
the default for data sets of the type specified by the 
corresponding name field of the DSTYPE parameter. 

specifies that the CAPS operand of the TSO EDIT 
command is the only permitted operand. The ASIS 
operand may not be specified on the TSO EDIT 
command. 

specifies IBM-standard data set types or new data set 
types defined by you that are to have their attributes 
modified or defined for use by the TSO EDIT com- 
mand. (See Figure 7). 

The name specified is the 1 to 8 character data set type 
as it will appear in the TSO EDIT command. Any data 
set type permitted by the TSO EDIT command or de- 
fined by the installation can be specified. Up to ten 
new data set types defined and up to fifteen standard 
data set types can be specified in this parameter. 

specifies, in bytes, the default and maximum allowable 
length of logical fixed-length records for data sets 
created by the TSO EDIT command. 

d is an integer from 1 to 255 that specifies the default 
logical record length for any fixed format data set of 
the type specified in the corresponding name field of 
the DSTYPE parameter. The corresponding n value, 
if specified in a BLOCK parameter, must be a multiple 
of this value. If the variable record format is the de- 
fault for the data set type (VAR=), a value of should 
be coded for d when this subparameter is used to de- 
fine the maximum size of a fixed-length record. 

m is an integer from 1 to 255 that specifies the maxi- 
mum logical record length of any fixed-format data 
set of the type specified in the corresponding name 
field of the DSTYPE parameter. The corresponding 
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EDIT 



Parameter Subparameter 

FIXED= d-m 

(Continued) (Continued) 



FORMAT= 



FIXED 



VAR 



FXDONLY 



PRMPTR= name 



USEREXT= name 



USERSRC= 



DATASET 
INCORE 



Explanation 

n value, if specified in a BLOCK parameter, must be 
a multiple of this value, and the m value must be 
greater than or equal to the d value. 
The hyphen must be coded as shown. 

specifies the allowable record format for new data 
sets created by the TSO EDIT command. 

specifies that fixed-record format is the default value 
for data sets of the type specified in the correspond- 
ing name field of the DSTYPE parameter. 

specifies that variable record format is the default 
value for data sets of the type specified by the 
corresponding name field of the DSTYPE parameter. 

specifies that only the fixed-record format is valid for 
data sets of the type specified in the corresponding 
name field of the DSTYPE parameter. Specifying the 
VAR parameter for this data set type is invalid. 

specifies the installation-supplied processor that is to 
be used by the RUN subcommand of the TSO EDIT 
command. RUN invokes an installation -supplied 
processor to execute programs under the TSO EDIT 
command. 

The name is the 1 to 8 character prompter name for 
the data sets of the type specified in the corresponding 
name field of the DSTYPE parameter. 

specifies the installation-supplied user exit routine 
that is to be invoked by the TSO EDIT command to 
interpret the parameters specified in the subfield of 
the DSTYPE operand of the TSO EDIT command. 
The interpreted parameters will be passed as part of 
the parameter list to the processor that is specified in 
the CHECKER parameter. This parameter cannot be 
used with any of the standard data set types. 

The name, which must be 1 to 8 characters long, is 
associated with data sets of the type specified in the 
corresponding name field of the DSTYPE parameter. 

specifies the type of input acceptable to the processor 
specified in the PRMPTR parameter in the TSO EDIT 
command. 

specifies that a sequential data set is the only allowable 
input to the specified processor. 

specifies that the TSO EDIT command may pass the 
input source to the specified processor in the form of 
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Parameter Subparameter Explanation 

USERSRC= INCORE an in-storage data set, if the source does not exceed 

(Continued) (Continued) 4096 bytes, or in the form of a sequential data set. 

VAR= d-m specifies, in bytes, the default and maximum allowable 

length of logical, variable-length records with variable- 
record format for new data sets created by the TSO 
EDIT command. 

d is an integer from 5 to 255 that specifies the default 
logical record length for any variable-format data set 
of the type specified in the corresponding name field 
of the DSTYPE parameter. The value specified must 
be less than or equal to n-4 of the corresponding n 
value specified in the BLOCK parameter. 

m is an integer from 5 to 255 that specifies the maxi- 
mum logical record length for any variable-format 
data set of the type specified in the corresponding 
name field of the DSTYPE parameter. The value 
specified must be less than or equal to n-4 of the 
corresponding n value specified in the BLOCK 
parameter. 

The hyphen must be coded as shown. 

Example: This example specifies that a new data set type, USER01, is defined for the TSO EDIT 
command. Its default record format is fixed and all other system defaults are used (see Figure 7). 
The standard data set type, DATA, will have a default blocksize of 2400 instead of 1680 (see 
Figure 7). All other standard data set types will use the default values that are specified in 
Figure 7. 

EDIT EDIT DSTYPE= (USER01, DATA) ,BLOCK=( 2400) , X 

FORMAT= (FIXED) 



DATA 

SET BLOCK- 
TYPE SIZE 



RECORD 
FORMAT 



Standard Data Set Types 



PLIF 

FORTE 

FORTG 

FORTH 

ASM 

TEXT 

DATA 

CLIST 

CNTL 

COBOL 

PLI 

IPLI 

BASIC 

GOFORT 

FORTG I 



400 

400 

400 

400 

1680 

1680 

1680 

1680 

1680 

400 

400 

1680 

1680 

1680 

400 



FXDONLY 

FXDONLY 

FXDONLY 

FXDONLY 

FXDONLY 

VAR 

FIXED 

VAR 

FXDONLY 

FXDONLY 

VAR 

VAR 

VAR 

VAR 

FXDONLY 



Default 

LRECL 
F V 



80 

80 

80 

80 

80 



80 



80 

80 









80 













255 



255 





104 

120 

120 

255 





Any User Defined Data Set Types 

1680 FIXED 80 

*IBM Program Product. 
— Null Value 



Maximum 
LRECL 
F V 



100 

80 

80 

80 

80 

255 

255 

255 

80 

80 

100 

120 

120 

255 

80 













255 

255 

255 





104 

120 

120 

255 



Data 
Conversion 



Checker 
Name 



CAPSONLY PLIFSCAN 

CAPSONLY IPDSNEXC 

CAPSONLY IPDSNEXC 

CAPSONLY IPDSNEXC 

CAPSONLY 

ASIS 

CAPS 

CAPSONLY 

CAPSONLY 

CAPSONLY 

CAPS PL I SCAN 

CAPSONLY IKJNC211* 

CAPSONLY IKJNC211* 

CAPS IPDSNEXC 

CAPSONLY IPDSNEXC 



Prompter 
Name 



Prompter 
Input 



DATASET 

DATASET 

DATASET 

DATASET 

ASM* DATASET 

DATASET 

DATASET 

DATASET 

DATASET 

COBOL* DATASET 

PLI DATASET 

IKJNC211* DATASET 

IKJNC211* DATASET 

GOFORT* INCORE 

FORT* DATASET 



Figure 7. Attribute defaults for parameters omitted from the EDIT macro 
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EDITOR 

Optional for: 
complete 

Not applicable for: 

nucleus 

I/O device 

The EDITOR macro instruction specifies the linkage editor options. This macro is optional. 
If it is not specified, the default values will be assumed. For additional information on the 
linkage editor, refer to OS/VS Linkage Editor and Loader. 



EDITOR [SIZE= (isizel ,size2 ))] 

| (118,24 j 

Parameter Subparameter Explanation 

SIZE= specifies the default values for the maximum number 

of bytes of virtual storage available to the linkage 
editor and to its corresponding text buffer. The 
values specified are multiples of 1024 (IK) bytes. 

size 1 is a value from 64K to 9999K (specified without the 

118 K). It specifies the amount of virtual storage available 

to the linkage editor. If this subparameter value is 
specified it must be coded first. If this subparameter 
is omitted, a value of 1 18 is assumed, resulting in 1 18K 
bytes. 

size 2 is a value from 6K to 100K (specified without the K). 

24 It specifies the amount of virtual storage available to 

the text buffer. If both subparameter values for the 
SIZE parameter are specified, this value must be 
coded last. If only this one is specified, it must be 
preceded by a comma. If this subparameter is omitted, 
a value of 24 is assumed, resulting in 24K bytes. 

Example: This macro specifies that 256K bytes of virtual storage will be available to the linkage 
editor and 24K bytes of virtual storage will be available to the corresponding text buffer. 

EDITOR EDITOR SIZE= (256) 
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GENERATE 

Required for: 
complete 
nucleus 
I/O device 

The GENERATE macro instruction is used to specify the object-module data set, the volume 
serial number and device type of the system residence volume of the system to be generated, 
the output class and jobclass used during system generation, and the type of generation being 
done. This macro instruction must be specified last. 

The GENERATE macro instruction produces the Stage II job stream that consists of several 
jobs so multijobbing may be used. If multijobbing is not used, the jobs will execute sequentially. 

For a complete generation the serial number specified in the RESVOL parameter cannot be the 
serial number of the system residence volume of the generating system. 

For a nucleus generation, the serial number and device type for the RESVOL parameter must 
be the same as the system residence volume of the system being modified, which could be the 
generating system. If you specify a value for the INDEX parameter other than SYS1 ., you 
must rename the system data sets that are to be updated to the value you specified. 

For an I/O device generation, the system being modified cannot be the generating system. The 
serial number specified in the RESVOL parameter cannot be the volume serial number of the 
system residence volume of the generating system. If you specify a value for the INDEX param- 
eter other than SYS1., you must rename the system data sets that are to be updated to the value 
you specified. 



GENERATE [GENTYPE=( ALL )1 

{(NUCLEUS,/?) 
((IO,n) 

[\NDEX= (name H 
\ SYS1 f 

[JCLASS=( c/ass)] 

[OBJPDS=fSYS1.Aiawe )1 
1 sYS1.QBJPDS ( 

[OCLASS=fc/ass)l 

[ R ESVOL= ( [ ( serial \][,l type }])] 
( SYSRES ) \2314f 



Parameter Subparameter Explanation 

GENTYPE= specifies the type of system generation. 

ALL specifies a complete system generation. 

NUCLEUS, n specifies that only a nucleus will be generated. The 

n is a number from 1 through 9 that specifies the 
number of the new member of SYS 1 .NUCLEUS 
being generated. The member name will be IEANUCOn. 
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Parameter 

GENTYPE= 

(Continued) 



INDEX= 



Subparameter 

NUCLEUS,n 
(Continued) 



IO,n 



name 
SYS1 



JCLASS= 


class 




A 


OBJPDS= 


SYS 1. name 




SYSl.OBJPDS 



OCLASS= 



RESVOL= 



class 
A 



serial number 
SYSRES 



type 
2314 



Explanation 

The value 1 is always assigned to the nucleus to be 
generated when GENTYPE=ALL is specified. There- 
fore, if 1 is specified in this subparameter, the new 
nucleus to be generated will replace the nucleus gen- 
erated during the last complete system generation. 

specifies an I/O device generation. The n is a number 
from 1 through 9 that specifies the number of the 
nucleus that is being modified. The member name will 
be IEANUCOn. 

specifies the qualifier for the new system data sets that 
will be created during system generation. The quali- 
fier may be from 1 to 6 alphameric characters, the 
first character alphabetic. If an index value other 
than the default value, SYS1 , is specified, the qualifier 
of the system data set affected is changed to SYS1 at 
the end of the system generation process. 

specifies the jobclass (A-O) to be used for output from 
Stage II of system generation. If this parameter is not 
specified, a value of A is used. 

specifies the partitioned data set to be used for the 
storage of the object modules that are assembled 
during Stage II of system generation. This data set 
must have been cataloged as SYS 1 .name in the gen- 
erating system before Stage II execution. If this 
parameter is omitted, SYS1 .OBJPDS is used. 

specifies the output class (A through Z or through 
9) to be used for output from Stage II of system gen- 
eration. If this parameter is not specified, a value of 
A is used. 

specifies the volume serial number and device type of 
the new system residence volume to be generated. 

specifies the volume serial number of the new system 
residence volume to be generated. If this parameter 
is omitted, SYSRES is used. 

specifies the unit address, device type, or group name 
for the new system residence volume to be generated. 
Valid device types are 2305-1, 2305-2, 2314, or 3330. 
If this parameter is omitted, 23 14 is used. 

If either subparameter is omitted, the default values 
areSYSRES,2314. 

If the serial number subparameter is omitted, the type 
subparameter must be preceded by a comma. 
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GENERATE 

Example: This example specifies a complete system generation. The partitioned data set that 
is to contain the object modules that are assembled during Stage II is SYS1 .TEMP. The system 
residence volume will reside on a 3330 and its volume serial number will be SYSRES. The 
qualifier for the new system data sets will be SYS1 . The job class for Stage II output is A and 
the output class is A. 

GEN GENERATE OBJPDS=SYSl. TEMP, X 

RESVOL= (SYSRES, 33 30) ,INDEX=SYS1, X 
JCLASS=A,OCLASS=A 
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GRAPHICS 

Optional for: 
complete 
nucleus 
I/O device 

The GRAPHICS macro instruction specifies the inclusion of graphic programming services 
(GPS). This macro instruction is optional. If it is not specified, GPS will not be included in 
the new system. For information about GPS, refer to OS/VS Graphic Programming Services 
(GPS) for IBM 2250 and OS/VS Graphic Programming Services (GPS) for IBM 2260. 

For a nucleus generation , if the new nucleus is to support the same set of graphic programming 
services that was included in the system during the last complete generation, then the GRAPHICS 
macro instruction must be coded exactly the way it was specified in the last complete system 
generation. GPS, however, cannot be added during a nucleus generation. 

GPS cannot be added during an I/O device generation. If the GRAPHICS macro instruction 
was specified during the last complete system generation, it must be respecified with exactly 
the same parameters and subparameters. 



GRAPHICS [GSP= ( INCLUDE ) ] 



| EXCLUDE 

[PORRTNS= ( EXCLUDE ) ] 
1 1NCLUDE f 



Parameter Subparameter Explanation 

GSP= specifies the inclusion of the graphic subroutine 

package (GSP) in SYS1 XINKLIB. 

INCLUDE specifies that GSP is to be included. 

EXCLUDE specifies that GSP is not to be included. If this 

parameter is not specified, EXCLUDE is used. 

PORRTNS= specifies the inclusion of problem-oriented routines 

(PORs) in SYS1.LINKLIB. 

EXCLUDE specifies that PORs are not to be included. 

INCLUDE specifies that PORs are to be included. If this 

parameter is not specified, INCLUDE is used. 

Example: This macro specifies that problem-oriented routines (PORs) are to be included 
in SYS1.LINKLIB and that the graphic subroutine package is not to be included in 
SYS1.LINKLIB. 

GRAPHICS GRAPHICS PORRTNS=INCLUDE 
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IODEVICE 

Required for: 
complete 
nucleus 
I/O device 

The IODEVICE macro instruction describes the characteristics of an input/ output (I/O) device 
and its system requirements. Each uniquely addressable I/O device in the operating system 
must be specified in an IODEVICE macro instruction. This macro instruction is required. 

For telecommunication devices there must be one IODEVICE macro instruction for each tele- 
communications line. The IODEVICE macro instruction applies to a telecommunications line, 
not to a terminal device. 

For telecommunication terminals, all terminals on a line must be of the same type with the same 
features. The type of terminal is used to identify the line in the UNIT parameter. 

The value specified in the ADDRESS parameter becomes the unit address of the device. Unit 
addresses are automatically assigned to the devices during system generation. 

During system generation, device types are also provided in the operating system for each type 
of device specified by the UNIT parameter of an IODEVICE macro instruction. Device types 
are described in Appendix A. 

A device or a collection of devices can be assigned a group name by use of the UNITNAME 
macro instruction. 

A maximum of 768 I/O devices can be specified during system generation. 

Figure 8 shows the valid combinations of values for the UNIT, MODEL, and FEATURE 
parameters. 

Figure 9 shows the values that can be specified for I/O devices in the FEATURE parameter. 

Figure 10 shows the valid combinations of values for telecommunications devices for the UNIT, 
ADAPTER, and TCU parameters. 

Burst devices cannot be specified for multiplexor channels. Burst devices are: 2250, 23 14, 
2401, 2420, 3330, 3410, and 3420. 

An IODEVICE macro instruction must be specified if a 2955 remote analysis unit is to be 
attached to the system. 

For a nucleus generation, the same IODEVICE macro instructions used during the last complete 
system generation must be respecified without changes. 

For an I/O device generation, all I/O devices that are to be in the new system must be specified. 
Except for the system residence device type, there can be additions, deletions, changes, or the 
same specifications as those in the last complete generation. 
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IODEVICE ADDRESS= (address } 

\ (address, number of units) \ 

[DEVTYPE=*ypel 
[ERRTAB=nnn] 

[ioreque=(fjfo )] 
^priority? 
(ordered) 

UNIT=Y device type \ 

) DUMMY \ 

f HASP -device type) 



The validity of the following parameters depends on the type of unit specified. See Figure 8 
for valid parameters and subparameters. 



J-21 ( 
J-22 ) 



ADAPTER=acfepter 

[EXPBFR= I number )] 
1 4096 J 

[FEATURE= (feature [.feature] ...)] 

GCU= / 2848-1 ^ 
2848-2 
2848- 
2848-22 

[NUMSECT=( number )] 
\16 f 

[MODEL=modei] 
OBRCNT=number 

[OPTCHAISN (address [.address] ...)] 

PCU=/7 

SETADDR=va/t/e 

TCU=(2701 ) 

{ 2702 ( 
I 2703 ) 



(2250-3 only) 



(2260-2 only) 



(2250-3 only) 



(BSC1,BSC2,BSC3 only for 
2715) 

(2305, 2314, 3330, 2401, 2420, 
3420, or DUMMY only) 

(2250-3 only) 

(TCU=2702 only) 

(Telecommunications devices) 



Parameter Subparameter Explanation 

ADAPTER= adapter specifies the terminal control or transmission adapter 

used to connect a telecommunications line to a trans- 
mission control unit. This parameter is required for 
all telecommuncation lines. Figure 10 associates 
terminal control adapters with transmission control 
units. 
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IODEVICE 



Parameter 
ADDRESS= 



Subparameter 



address 



number of units 



DEVTYPE= 



type 



ERRTAB= 



nnn 



EXPBFR= 



number 
4096 



Explanation 

specifies the unit address of devices or telecommuni- 
cation lines. The value specified in the ADDRESS 
parameter becomes the unit address of the device. 
For each device address that is assembled, a unit 
control block (UCB) is created. 

specifies the unit address, consisting of three hexa- 
decimal digits from 000 to FFF. The high-order 
digit is the address of the channel (specified in the 
CHANNEL macro instruction) to which the device 
is attached. 

specifies the number of units to be used and the total 
number of sequential addresses to be assembled. The 
value can be a number from 1 to FFF. For example, 
if ADDRESS=(130,5) is specified, the unit addresses 
130,131, 132, 133, and 134 would be assembled. 

If this subparameter is omitted, a value of 1 is assumed 
for all devices except the 2314, which has a default of 
8 and the 3330 which has a default of 2. The maximum 
value that can be specified for a 3330 in one IODEVICE 
macro is 8. This parameter value is ignored for the 2305. 

specifies any additional characteristics of the device. 
The value specified must be 8 hexadecimal characters. 
This parameter need not be specified for any IBM- 
supported device. This parameter should be specified 
if UNIT=DUMMY is specified. 

For further information about this parameter value, 
refer to the description of the UCB in OS/VS2 Sys- 
tem Data Areas. 

specifies that an error routine other than a standard 
error routine is to be used for the device. Either an 
IBM-supplied routine or your own routine may be 
specified. 

IBM error routines have the values 000 through 219 
and 230 through 254. Your own routines can have 
values 220 through 229. This value is the suffix of 
the name IGE00, under which the error routine is 
stored in SYS l.LPALIB. 

The ERRTAB parameter should be specified if 
UNIT=DUMMY is specified. 

specifies the amount of buffer space, in bytes, re- 
quired by programs written for a 2250 model 1 that 
use EXPRESS attention handling routines and that 
can be used with a 2250 model 3 attached to a 2840. 
The value may be an integer from 1 to 8192. If this 
parameter is not specified, 4096 (bytes) is used. 
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Parameter 

EXPBFR= 

(Continued) 

FEATURE= 



GCU= 



IOREQUE= 



Subparameter 

number 
4096 



(Continued) 
feature 



/ 2848-1 
I 2848-2 
) 2848-21 
V 2848-22. 



FIFO 

PRIORITY 

ORDERED 



MODEL= 


model 


NUMSECT= 


number 




16 



Explanation 

For information on the 2250, refer to OS/VS Graphic 
Programming Services (GPS) for IBM 2250. 

specifies the optional features that the device has. 
These values can be written in any order. Refer to 
Figure 8 for the valid features that may be specified 
for the devices and to Figure 9 for a summary of fea- 
tures that may be specified. 

specifies the type of graphic control unit (GCU) to 
which a 2260 model 2 is attached. One of these 
graphic control units must be specified for each 2260 
model 2. 

For information on the 2260, refer to OS/VS Graphic 
Programming Services (GPS) for IBM 2260. 

specifies the type of I/O request queuing to be pro- 
vided by the supervisor for the device. If this param- 
eter is not specified, FIFO is used. 

specifies first-in-first-out queuing. 

specifies queuing according to task priority. 

specifies queuing according to cylinder address. 

IOREQUE=ORDERED may be specified only for the 
2314 or 3330. If it is specified for any other device, 
FIFO is substituted. 

specifies the model number, if any, for the device. 
This parameter must be specified if the device has a 
model number (see Figure 8). 

specifies the number of 256-byte buffer sections in a 
2840 display control unit to be assigned to a 2250 
model 3. These buffer sections can be used only by 
the device being specified. 

The value of the number specified is from 1 to a maxi- 
mum value that is determined by the following 
formula: 



256 



- B + 1 



where 

A is the size of the 2840 buffer 

B is the number of devices attached to the 2840. 

The total number of buffer sections guaranteed to the 
devices attached to a 2840 must not exceed the num- 
ber of sections in the buffer of that 2840. 
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Parameter 

NUMSECT= 

(Continued) 



Subparameter 

number 

16 

(Continued) 



OBRCNT= 



address 
800 



OPTCHAN= 



address 



IODEVICE 

Explanation 

If this parameter is not specified, the device uses the 
284Q control unit buffer sections that are not assigned 
to other devices attached to the 2840. However, there 
must always be at least one section available for as- 
signment to each device attached to the 2840. 

If a 2250 model 3 is specified as an operator console 
and this parameter is not specified or its value is 
less than 16, a value of 16 is used. 

For information on the 2250, refer to OS/VS Graphic 
Programming Services (GPS) for IBM 2250. 

is a number from to 800 that specifies the number 
of area stations connected to the 2715 transmission 
control in a 2790 data communications system. 

The total of all values specified in this parameter can- 
not exceed 800 during system generation. If 800 is 
exceeded, 800 is assumed. 

specifies the alternate channels through which any of 
the following devices may be addressed: 2305, 2314, 
2401 , 2420, 3330, 3420, or DUMMY (a device not 
supported by IBM). The value of the address speci- 
fied must be greater than the high-order digit of the 
value in the ADDRESS parameter of this macro. The 
address of a high-speed multiplexor subchannel must 
be specified as 2 characters; the first, the channel ad- 
dress of the selector channel, the second, D, E, or F. 

There is a maximum of 768 optional channel paths 
per configuration. Each value specified is the address 
of an alternate channel that was specified in the 
CHANNEL macro instruction. The alternate path 
retry feature of the I/O supervisor becomes part of the 
system when the OPTCHAN parameter is specified. 

There must be no more than one IODEVICE macro 
instruction for each I/O device, regardless of the 
number of alternate addresses given to the device. 
For example, if the primary address of a device is 
181 , and if it can also be addressed through channels 
2, 3, and 4, there must not be separate IODEVICE 
macro instructions defining the address of the device 
as either 281, 381, or 481. The primary address of 
the device, that is, the one with the lowest channel 
address, must be specified in the ADDRESS param- 
eter. The other channel addresses must be specified 
in the OPTCHAN parameter. In this example, the 
macro instruction for the device must contain the 
parameters ADDRESS=181 and OPTCHAN=(2,3,4). 
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Parameter 
PCU= 



Subparameter 

n 



SETADDR= value 



TCU= 



UNIT= 




device type 



Explanation 

specifies the number assigned to the physical control 
unit (2840) to which this 2250 model 3 is attached. 
The n is a number from 1 to 99. Each physical 2840 
must be uniquely identified by this parameter. The 
same 2840 should be considered a different physical 
control for each channel attached to it. For example, 
for two 2250s with addresses 3D2, 3D3, 4D2, and 
4D3 attached to the same 2840(D) but attached to 
two different channels (3 and 4), the PGU parameter 
might be PCU=1 for 3D2 and 3D3 and PCU=2 for 
4D2 and 4D3. A 2250 on any 2840 cannot have a 
unit address that is within the range of addresses of 
any 2250 on another 2840 or any other unit address. 
For example, 122, 124 cannot be assigned to any 
2250s if 121, 125, and 126 are addresses of 2250s on 
another 2840 or if 123 is the address of another device. 

specifies which of the four set address (SAD) com- 
mands is to be issued to the transmission control unit 
(TCU) for operations on the line specified by the 
ADDRESS operand (2702 only). The SAD command 
selects the appropriate line speed for the terminal con- 
nected to the line. The association between the specific 
command and the corresponding line speed is estab- 
lished by internal connections within the 2702. The 
value for the SAD command is one of the following: 

2 

1 3 

This parameter is required for the 2702. 

If the TCU is a 2701 or 2703, the SAD commands are 
ignored. 

specifies the teleprocessing control unit for a telecom- 
munications line. This parameter is required for all 
telecommunications lines. Figure 10 associates terminal 
control adapters with transmission control units. 

specifies the device type. In the case of telecommuni- 
cation lines, this parameter specifies the device type 
that is connected to a telecommunication line, or the 
type of binary synchronous line configuration: non- 
switched point-to-point (BSC1), switched point-to- 
point (BSC2), or nonswitched multipoint (BSC3). 
Binary synchronous may also be specified by 
UNIT=2780, 1 130, 2020, or S360. 

Figure 8 lists and defines the devices that may be 
specified in the UNIT parameter and the valid com- 
binations of parameters that may be specified. 
Appendix A describes the device types. 

The 2319 drives are functionally equivalent to the 2314 
drives. The default value is eight drives. If you use less 
than eight drives, you must specify the number of 
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Parameter 

UNIT= 

(Continued) 



Subparameter 

device type 
(Continued) 



DUMMY 



HASP- device 
type 



IODEVICE 

Explanation 

drives (see ADDRESS= in this section). To use a 
23 19, specify UNIT=2314. Appendix D contains a 
description of the 2319. 

The IBM 3333 Disk Storage and Control is function- 
ally equivalent to the IBM 3330 Disk Storage Drive. 
To use a 3333, specify UNIT=3330. Appendix D 
contains a description of the 3333. 

specifies a device that is not supported by IBM. When 
DUMMY is specified, a 32-byte UCB with all its 
standard fields is generated. It is assumed that you 
provide your own I/O support routines for the device. 

If you want to refer to the device using job control 
language statements, you must generate a unit address 
with the UNITNAME macro instruction. Unit ad- 
dresses for DUMMY devices are not automatically 
generated. 

specifies a HASP device. Valid device types that may 
be specified are: 1403, 1442, 1443, 2520, 2540R, 
and 2540P. 



Example: This macro defines a 3210 console with a unit address of 009. The IOREQUE 
parameter was not specified so the default option for the I/O request queuing of FIFO (first- 
in-first-out) is assumed. 



C009 



IODEVICE 



UNIT=3210 ,ADDRESS=009 



Example: This macro defines a 2540 Model 1 card punch with the CARDIMAGE feature. The 
unit address for the device is 00D. The default value, FIFO, was taken for the I/O request 
queuing parameter. 



P-00D IODEVICE UNIT=2540P,ADDRESS=(00D) , 
FEATURE= (CARDIMAGE) ,MODEL=l 



X 



Example: This macro defines a 2314 with 6 drives. UCBs will be generated for addresses 130 
through 135. Channel 2 is defined as an alternate channel. (No other device may be specified 
with addresses 230 through 235.) The default value, FIFO is assumed for the I/O request 
queuing parameter (IOREQUE). 



D2314 IODEVICE UNIT=2314 ,ADDRESS= (130 , 6) , 
OPTCHAN= ( 2 ) 



X 
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FEATURE 1 


Optional 




UNIT 


MODEL 


(optional) 


Parameters 


Notes 


Direct-Access Devices 


2314 




SHARED 


IOREQUE= 
( FIFO ) 

) priority}* 
/ orderedj 

OPTCHAN= 
{(n,n[,n])J 


Direct Access Storage Facility 

The 2314 must have the 2-channel switch 
feature or the 2844 to allow FEATURE= 
SHARED and/or OPTCH AN. The 2844 
Auxiliary Storage Control allows the 2314 
to be addressed through up to four chan- 
nels: the primary and three alternate, or 
the primary, one or more shared with 
another processing unit, and one or more 
shared in the same processing unit. 


3330 




SHARED 


IOREQUE= 
( FIFO ) 
/ PRIORITY^ 

j ordered) 

OPTCHAN= 
{(n,n[,n])| 


Disk Storage Drive 

The device's control unit must have the 
4-channel switch feature for FEATURE= 
SHARED or OPTCHAN to be supported. 
A maximum of three alternate channels 
may be specified. The addresses of 
alternate channels may be written. 


Drum 


2305 


1 or 2 


SHARED 


IOREQUE= 
(FIFO \ 
(PRIORITY) 

OPTCHAN= 
n 


Fixed Head Disk Storage 

The 2305 Model 1 can only be specified in 
a CPU Model 165II system configuration. 
FEATURE=SHARED and the OPTCHAN 
parameter are mutually exclusive for the 
device. 


Display devices 


1053 


4 




IOREQUE= 
( FIFO | 
(PRIORITY) 


Printer 


2250 


1 


ABSLTVEC 


IOREQUE= 


Display unit 






ALKYB2250 
(BUFFER4K) 
(BUFFER8K / 
CHARGNTR 


(FIFO ) 
(PRIORITY f 

EXPBFR=n 


Refer to the "Unit Record" part of this 
figure for specifying this device as an oper- 
ator's console. 






DESIGNFEAT 










lightpen 










PRGMKYBD 







Figure 8 (Part 1 of 9). Parameter values that may be specified in an IODEVICE macro instruction 
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IODEVICE 



UNIT 



MODEL 



FEATURE 1 
(optional) 



Optional 
Parameters 



Notes 



Display Devices (Continued) 



2250 

(Cont) 



ALKYB2250 
PRGMKYBD 



IOREQUE= 
( FIFO ) 

(priority/ 



NUMSECT=n 

EXPBFR=n 

PCU=n 



Display unit 

The parameter PCU is required for the 2250 
Model 3. 

Refer to the "Unit Record" part of this 
figure for specifying this device as an 
operator's console. 



2260 



1 or 2 



(ALKYB2260) 
(DEKYB2260J 
LINEADDR 
NODESCUR 
NMKYB2260 



IOREQUE= 
( FIFO ^ 

(PRIORITY/ 
GCU=control 
unit 



Display station 

The GCU parameter is required for the 
2260 Model 2. 

Refer to the "Unit Record" part of this 
figure for specifying this device as an 
operator's console. 



2260 

or 
2265 



IOREQUE= 
( FIFO \ 

(priority/ 

ADAPTER= 

IBM3 
TCU=2701 



Display station 

When the unit is specified as a remote de- 
vice, the MODEL and FEATURE param- 
eters are not specified. 



3158 



EBKY3277 
ASKY3277 
DEKY3277 
OCKY3277 

SELPEN 
KB78KEY 



Display unit 

Refer to the "Unit Record" part of this 
figure for specifying this device as an 
operator's console. 



3277 



1 or 2 



ASCACHAR 
ASCBCHAR 
KACHAR 

DOCHAR 
FRCHAR 
GRCHAR 
UKCHAR 

AUDALRM 
MAGCDRD 
NUMLOCK 
SELPEN 



Display unit 

Refer to the "Unit Record" part of this 
figure for specifying this device as an 
operator's console. 

Only one type of character generator may 
be specified. If none are specified, DOCHAR 
is used as the default. 

Only one type of keyboard may be specified. 
If none are specified, a 66-key keyboard is 
assumed. 

The AUDALRM feature can only be speci- 
fied if a keyboard has been specified. 
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UNIT 



MODEL 



FEATURE 1 
(optional) 



Optional 
Parameters 



Notes 



Display Devices (Continued) 



3277 
(Cont) 



1 or 2 
(Cont) 



EBKY3277 
ASKY3277 
DEKY3277 
OCKY3277 

KB70KEY) 
KB78KEY > 
KB81KEY) 



3284 



1 or 2 



DOCHAR 
FRCHAR 
GRCHAR 
KACHAR 
UKCHAR 



Printer 



3286 



1 or 2 



DOCHAR 
FRCHAR 
GRCHAR 
KACHAR 
UKCHAR 



Printer 



Magnetic Tape Units 



2401 



1,2,3 



4,5,6 



READWRITE 
MDECOMPAT 
i 7-TR ACK ) 
(9-TRACK/ 
DATACONV 



READWRITE 
9-TRACK 
DUALDENS 



IOREQUE= 
IHFQ. I 

(PRIORITY^ 
OPTCHAN=n 



Magnetic tape unit 

FEATURE=9-TRACK is assumed if the 
FEATURE parameter is omitted. 



2401 



7-TRACK 
READWRITE 



IOREQUE= 
(HFO I 

^priority/ 

OPTCHAN=n 



Magnetic tape unit 

The DATACONV feature is standard for 
the 2401-8. 

READWR ITE is required and valid only if 
the 2401-8 is attached to a 2804-3. 



2420 



IOREQUE= 
|FlfO \ 

(PRIORITY) 
OPTCHAN=n 



Magnetic tape unit 

This is a 9-track 1600 BPI drive only so the 
FEATURE parameter is not required. 



2495 



IOREQUE= 
( FIFO } 

(PRIORITY] 



Magnetic tape cartridge reader 



Figure 8 (Part 3 of 9). Parameter values that may be specified in an IODEVICE macro instruction 
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IODEVICE 



UNIT 


MODEL 


FEATURE 1 
(optional) 


Optional 
Parameters 


Notes 


Magnetic Tape Units (Continued) 


3410 


1,2,3 


p-TRACK \ 
(9-TRACK f 
DUALDENS 


IOREQUE= 
(FIFO | 

(priority! 


Magnetic tape drive 


3420 


3,5,7 


(7-TRACK) 
1 9-TR ACK f 
DUALDENS 
SHARABLE 


IOREQUE= 
(FIFO \ 
(PRIORITY) 

OPTCHAN= 
n 


Magnetic tape drive 


Optical Character Readers 


1275 

or 

1287 

or 

1288 






IOREQUE= 
(FIFO \ 
(PRIORITY) 


The address specified must be the address 
of the primary control unit and must be an 
even number. There must be only one 
IODEVICE macro for each 1275. Two 
addresses are generated by the one 
IODEVICE macro. 

The 1275 is available through IBM World 
Trade Corporation branch offices. 


Magnetic Ink Character Readers 


1419 






IOREQUE= 
(FIFO \ 
(PRIORITY/ 


The address specified must be the address 
of the primary control unit and must be an 
even number. There must be only one 
IODEVICE macro for each 1419. Two 
addresses are generated by the one 
IODEVICE macro instruction. 


Unit Record Devices 2 


1052 


7 




IOREQUE= 
(FIFO ) 
(PRIORITY/ 


Printer-keyboard 

Installed in combination with the 2150 
Control Unit. 


2250 


1 


ALKYB2250 

(BUFFER4K) 

(BUFFER8KJ 

CHARGNTR 

LIGHTPEN 

PRGMKYBD 


IOREQUE= 
(FIFO \ 

(priority/ 


Display unit 

LIGHTPEN and PRGMKYBD are optional; 
other features are required if the 2250 
Model 1 is used as a console device. 



Figure 8 (Part 4 of 9). Parameter values that may be specified in an IODEVICE macro instruction 
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UNIT 


MODEL 


FEATURE 1 
(optional) 


Optional 
Parameters 


Notes 


Unit Record Devices 2 (Continued) 


2250 


3 


ALKYB2250 
PRGMKYBD 


IOREQUE= 
(FIFO ) 
(PRIORITY/ 

NUMSECT= 
n 

EXPBFR= 
n 

PCU=n 


Display unit 

If the 2250 Model 3 is being used as a con- 
sole device: 

• A LKYB2250 is required . 

• If NUMSECT is omitted or less than 16, 
16 is used. 

• The PCU parameter is required. 


2260 


1 


LINEADDR 

ALKYB2260 

NODESCUR 


IOREQUE= 
(FIFO \ 
\ PRIORITY/ 


Display Station 

If the 2260 Model 1 is being used as a con- 
sole device, LINEADDR and ALKYB2260 
are required. 


3066 






IOREQUE= 
(FIFO ) 
(PRIORITY/ 


The system console for the System /3 70 
Models 165IIand168. 


3210 

or 

3215 






IOREQUE= 
(FIFO | 
(PRIORITY/ 


Console-printer keyboard 


3277 


2 


/ASKY3277 \ 
I DEKY3277 / 
j EBKY3277 ( 
IOCKY3277 J 

KB78KEY 
SELPEN 




If the 3277 is being used as a console device 
with input capability, a keyboard must be 
specified. 

The 3277 Model 1 can be used only as an 
output-only console to display operator 
messages; optional features or parameters 
cannot be specified. 


3158 




/EBKY3277 \ 
IaSKY3277 / 
JDEKY3277 j 
lOCKY3277/ 

SELPEN 
KB78KEY 




Display console with keyboard 


1403 


N1 or 
2 


UNVCHSET 


IOREQUE= 
(RFO \ 
(PRIORITY/ 


Printer 


7 




UNVCHSET is invalid for the 1403-7. 


1443 


N1 


SELCHSET 
24ADDPOS 


IOREQUE= 
(FIFO I 
(PRIORITY/ 


Printer 



Figure 8 (Part 5 of 9). Parameter values that may be specified in an IODEVICE macro instruction 
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IODEVICE 



UNIT 


MODEL 


FEATURE 1 
(optional) 


Optional 
Parameters 


Notes 


Unit Record Devices 2 (Continued) 


3213 






IOREQUE= 
(HFO \ 
(PRIORITY) 


Console-printer with no keyboard 


3211 






IOREQUE= 
( FIFO ) 
( PRIORITY/ 


High-speed printer 

The universal character set is a standard 
feature. 


2501 


B1or 
B2 


CARDIMAGE 


IOREQUE= 
{FIFO \ 
(PRIORITY/ 


Card reader 


2520 


B1 


CARDIMAGE 


IOREQUE= 
(RFO \ 
(PRIORITY/ 


Card reader punch 


B2or 
B3 


Card punch only 


2540R 

or 

2540P 


1 


CARDIMAGE 


IOREQUE= 
(FIFO ) 
(PRIORITY / 


Card reader punch 

The 2540R and 2540P are specified for the 
same 2540 Card Reader Punch. 

Two IODEVICE macro instructions must 
be specified. 


3505 




CARDIMAGE 


IOREQUE= 
/FIFO \ 

(priority/ 


Card reader and control unit 


3525 




cardimage 

(twoline \ 
(multiline/ 


IOREQUE= 
(FIFO ) 
(PRIORITY/ 


Card punch 

Every 3525 specified must be attached 
to a 3505. 


2671 


1 


' 


IOREQUE= 
/FIFO \ 

(priority/ 


Paper tape reader 


Telecommunications 3 


1030 




AUTOPOLL 


IOREQUE= 
i FIFO ) 
( PRIORITY/ 

SETADDR= 
value 


Data collection system 
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UNIT 



MODEL 



FEATURES 1 
(optional) 



Optional 
Parameters 



Notes 



Telecommunications 3 (Continued) 



1050 



1050X 



1060 



2740 



2740C 



2740X 



274 1C 
or 
274 1P 



115A 



AUTOANSR 
AUTOCALL 
AUTOPOLL 



AUTOCALL 
AUTOANSR 



AUTOPOLL 



AUTOANSR 

AUTOCALL 

AUTOPOLL 

CHECKING 

SCONTROL 

XCONTROL 

OIU 

INTERRUPT 



CHECKING 
AUTOANSR 



CHECKING 
AUTOCALL 
AUTOANSR 



AUTOANSR 



IOREQUE= 

trim \ 
(priority) 

SETADDR= 
value 



•Trademark of Western Union Telegraph Company 



Data communication system 

AUTOPOLL cannot be specified if either 
AUTOANSR or AUTOCALL (or both) is 
specified. 



Refers to the 1050 with the time-out sup- 
pression feature. 



Data communication system 



Communication terminal 

AUTOPOLL cannot be specified if either 
AUTOANSR or AUTOCALL (or both) is 
specified. 

If the 2740 is specified as a console, then it 
must have the record checking feature. 

The communications line must be non- 
switchable and only one 2740 per com- 
munications line can be specified as a con- 
sole device. 

CHECKING must be specified if the OIU 
feature is specified. 

SCONTROL and XCONTROL cannot be 
specified if OIU is specified. 

If RPQ#S330031 is installed, FEATURE= 
INTERRUPT may be specified. 



Communications terminal with correspond- 
ence code. 

CHECKING is required. 



Communications terminal with PTTC code. 
CHECKING is required. 



Communications terminal with correspond- 
ence code or communications terminal with 
PTTC code. 



Western Union* Terminal 
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IODEVICE 



UNIT 


MODEL 


FEATURE 1 
(optional) 


Optional 
Parameters 


Notes 


Telecommunications 3 (Continued) 


83B3 






IOREQUE= 
(FIFO | 
(PRIORITY) 

SETADDR= 

value 


AT&T* Selective Calling Terminal 


TWX 




AUTOANSR 
AUTOCALL 


Teletype** Models 33 or 35 


WTTA 






IBM World Trade Corporation 
Telegraph Terminal 


BSC1 




DUALCODE 5 
DUALCOMM 


IOREQUE= 
/FIFO \ 

(priority/ 

OBRCNT=n 


BSC 4 station nonswitched point-to-point 
line. 


BSC2 




DUALCODE 5 
DUALCOMM 
AUTOANSR 
AUTOCALL 


BSC 4 station switched point-to-point line. 


BSC3 




DUALCODE 5 
DUALCOMM 
AUTOPOLL 


BSC 4 station nonswitched multipoint line. 
AUTOPOLL is assumed. 


7770 


3 




IOREQUE= 
/FIFO \ 

(priority/ 


Audio response unit 


2955 






IOREQUE= 
(FIFO ) 
(PRIORITY/ 


Remote analysis unit 

If this device is to be attached, an 
IODEVICE macro instruction must be 
specified. 


3705 






ADAPTER= 
(CM \ 
(CA2J 


Communications control unit 

An adapter must be specified for the 3705. 


•Trademark of American Telephone and Telegraph Company. 
* 'Trademark of the Teletype Corporation. 
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1 Figure 9 lists and defines all of the options that can be specified through the FEATURE parameter. 

Figure 11 lists all of the devices that can be used as consoles. 

Figure 10 lists the terminal control or transmission adapters (ADAPTER) used to connect a telecommunications I/O device 
(UNIT) to a transmission control unit (TCU). 

BSC (Binary Synchronous Communications) stations can be any of the following: 
System/3 Processor Station 
System/360 Processor Station 
System/370 Processor Station 
System/360 Model 20 Processor Station 
1130 Processor Station 
1800 Processor Station 
2770 Data Communications System 
2780 Data Transmission Terminal 
2790 Data Communications System 
2972 Model 8 and 11 Bank Terminal 
3275 Display Station (BSC3 only) 
3277 Display Station (BSC3 only) 
3284 Printer Controller (BSC3 only) 
3286 Printer Controller (BSC3 only) 
3670 Brokerage Terminal 
3735 Programmable Buffer Terminal (BSC2 and BSC3 only) 

If DUALCODE and/or DUALCOMM is specified, the telecommunications device can only be connected to a 2701. If 
AUTOANSR and/or AUTOCALL or AUTOPOLL is specified, the telecommunications device can be connected to either a 
2701 or 2703. 
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IODEVICE 



Feature 


Unit 


Description 


ABSLTVEC 


2250-1 


Absolute vectors and control; enables the device to trace continuous straight 
lines at any angular position within the display area. 


ALKYB2250 

or 
ALKYB2260 


2250 
2260 


Alphameric keyboard; permits you to enter messages consisting of letters, 
numbers, and other symbols. 


ASCACHAR 


3277 


ASCII A character generator. 


ASCBCHAR 


3277 


ASCII B character generator. 


ASKY3277 


3158 
3277 


ASCII typewriter keyboard. 


AUDALRM 


3277 


Audible alarm feature. 


AUTOANSR 


BSC2 

TWX 

1050 

1050X 

2740 

2740C 

2740X 

2741C 

274 1P 


The modem connecting the telecommunications line specified by the address 
operand to the TCU is a switched line over which calls are to be answered. 


AUTOCALL 


BSC2 

TWX 

1050 

1050X 

2740 

2740X 


The TCU to which the remote station is connected is equipped with the auto 
call feature and the line is connected to the TCU terminal adapter by means of 
an automatic calling unit and an appropriate modem. 


AUTOPOLL 


BSC3 
1030 
1050 
1060 
2740 


The automatic polling feature of the TCU is to be used. This feature is standard 
for the 2703 and optional for the 2702. This feature, when the TCU is a 2701 , 
is valid only for lines connected through a synchronous data adapter type II. 
When this feature is on the 2740, SCONTROL must also be specified. 


BUFFER4K 

or 
BUFFER8K 


2250-1 


This feature provides the display unit with either 4096 bytes or 8192 bytes of 
virtual storage for display regeneration. 
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Feature 


Unit 


Description 


CARDIMAGE 


2501 

2520 

2540P-1 

2540R-1 

3505 

3525 


This feature provides reading and/or punching in card-image mode. For the 
2540R and 2540P, the 2821 Control Unit must have the column-binary 
feature installed. 


CHARGNTR 


2250-1 


Character generator; allows alphameric characters to be displayed on a cathode 
ray tube. The feature is standard on the 2250-3 and 2260. 


CHECKING 


2740 

2740C 

2740X 


The 2740 Communication Terminal is equipped with the record checking 
feature. 


DATACONV 


2401 


The data conversion feature allows the writing and reading of binary data on 
7-track 2400 tape units. 


DEKYB2260 


2260 


This feature specifies an alphameric keyboard with numeric inset for the 2260. 
The numeric keys are inset in the keyboard in a block arrangement for rapid 
numeric data entry. 


DEKY3277 


3158 
3277 


EBCDIC data entry keyboard. 


DESIGNFEAT 


2250-1 


Graphic design feature for the 2250 Model 1 provides incremental vectors and 
point plotting, a special fiber optics light pen, and light pen control orders. 
This feature is standard on the 2250-3. ABSLTVEC must also be specified. 


DOCHAR 


3277 


Domestic character generator. 


DUALCODE 


BSC1 
BSC2 
BSC3 


The TCU (2701 only) is equipped with the dual code feature. The feature 
allows processing program selection of the transmission code to be used on the 
communications line. 


DUALCOMM 


BSC1 
BSC2 
BSC3 


The TCU (2701 only) is equipped with the dual communication interface 
feature. This feature allows program selection of either of two modems over 
which transmission is to occur. 


DUALDENS 


2401 
3410 
3420 


The dual density feature allows a program to utilize the tape unit as either an 
800 BPI or a 1600 BPI machine. 


EBKY3277 


3158 
3277 


EBCDIC typewriter keyboard. 


FRCHAR 


3277 
3284 
3286 


French character generator. 
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IODEVICE 



Feature 


Unit 


Description 


GRCHAR 


3277 
3284 
3286 


German character generator. 


INTERRUPT 


2740 


This feature indicates that the 2740 is a Model 1 with RPQ #30031 added to 
allow improved performance when the 2740 is being used as a console. 


KACHAR 


3277 
3284 
3286 


Katakana character generator. 


KB70KEY 


3277 


70-key keyboard on the 3277. 


KB78KEY 


3158 
3277 


78-key keyboard. The feature can only be specified in ASKY3277, EBKY3277, 
or OCKY3277 is specified. 


KB81KEY 


3277 


81 -key keyboard. 


LIGHTPEN 


2250-1 


A light pen is a pen-like device that enables the operator to identify to the 
program a particular point, line, or character in the displayed image. 


LINEADDR 


2260 


Line addressing is a special feature on the 2848 control unit for the 2260. 
The feature permits selection of display starting location on incoming data 
under program control. 


MAGCDRD 


3277 


This feature specifies a magnetic card reader adapter. 


MDECOMPAT 


2401 


The mode compatibility feature enables NRZI tape units (Models 1, 2, and 3) 
to operate with phase-encoding (PE) tape controllers (2803-2 or 2804-2). 


MULTILINE 


3525 


This feature allows the 3525 Card Punch with the print feature to print up to 
25 lines on a card. 


NMKYB2260 


2260 


The numeric keyboard feature specifies that the keyboard is organized like a 
10-key adding machine. 


NODESCUR 


2260 


The nondestructive cursor is a feature on the 2848 control unit for the 2260. 
The feature allows the operator to move the cursor anywhere on the display 
without changing displayed information. 


NUMLOCK 


3277 


Numeric lock feature. 


OCKY3277 


3158 
3277 


This feature specifies a 78-key operator console keyboard on the 3277 or 3158. 
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Feature 


Unit 


Description 


OIU 


2740 


The presence of a 2760 Optical Image Unit at a 2740 Communications Termi- 
nal is specified by this feature. CHECKING must also be specified. 
AUTOANSR and AUTOCALL are the only additional optional features that 
are valid with this feature. 


PRGMDYBD 


2250 


Program med-functi on keyboard is a 32-key general-purpose keyboard. The 
keys of the keyboard are basically unidentified, with their functions defined 
by application programs. 


READWRITE 


2401 


The feature is specified when the tape device is attached to a simultaneous 
read-write control unit (2804-1 ). When this feature is used, OPTCHAN must 
specify an alternate channel. 


SCONTROL 


2740 


The 2740 Communication Terminal is equipped with the station control 
feature which allows the terminal to react to a poll or address from a user 
program. This feature and the AUTOANSR, AUTOCALL, OIU, and 
XCONTROL features are mutually exclusive. 


SELCHSET 


1443 


The selective character set feature specifies character sets other than the stand- 
ard 52-character set. 


SELPEN 


3158 
3277 


Selector pen. 


SHARABLE 


3420 


This feature allows 3420 magnetic tape drives to be shared between two central 
processing units when the 3803 two-channel switch is used for partitioning. 


SHARED 


2305-2 

2314 

3330 


This feature allows the system to share direct-access storage devices with other 
systems. The device's control unit must be equipped with the 2-channel or 
4-channel switch feature. 


TWOLINE 


3525 


This feature allows the 3525 card punch with the print feature to print 1 or 2 
lines on a card. 


UKCHAR 


3277 
3284 
3286 


United Kingdom character generator. 


UNVCHSET 


1403-2 
1403-N1 


The universal character set feature provides for printing any set of graphic 
characters (240 maximum) by the printer specified that is attached to a 2821 
Control Unit. The IBM character set images are specified in the UCS macro 
instruction. 


XCONTROL 


2740 


The 2740 Communication Terminal is equipped with the dial-up feature. 
The AUTOANSR or AUTOCALL feature, or both, as appropriate, must also 
be specified. XCONTROL and OIU are mutually exclusive. 
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IODEVICE 



Feature 


Unit 


Description 


24ADDPOS 


1443 


The standard printed line for all character sets on the 1443 is 120 characters 
long. This feature specifies 24 additional print positions. 


7-TRACK 

or 
9-TRACK 


2401 
3420 


The 7-track feature enables the 2400 and 3400 tape units to process tapes that 
are compatible with other IBM computers that utilize such tape units as the 
727, 729, or 7330. These tape units read and write tape in the binary coded 
decimal (BCD) or binary format. Nine-track is the default. These features 
are mutually exclusive. 

The 3410 can only process 9-track tape units. 
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Adapter 


Unit 


TCU 


Description 


BSCA 


BSC1 
BSC2 
BSC3 


2701 
2703 


Synchronous data adapter, type II, and an appropriate modem. 
Synchronous terminal control and an appropriate modem. 


IBM1 


1050 
1050X 
1060 
2740 
2740C 
2740X 
2741 C 
2741 P 


2701 

2702 
2703 


IBM terminal adapter, type I, and an appropriate modem or an IBM line 
adapter. 

IBM terminal control, type I, and either a data set line adapter and an 
appropriate modem or an IBM line adapter. 


IBM2 


1030 


2701 

2702 
2703 


IBM terminal adapter, type II, and either an appropriate modem or an IBM 
line adapter. 

IBM terminal control, type II, and either a data set line adapter and an 
appropriate modem or an IBM line adapter. 


IBM3 


2260 
2265 


2701 


IBM terminal adapter, type III, and an appropriate modem. 


IBMT 


1050 
1050X 


2701 
2703 


IBM telegraph adapter. 

IBM terminal control, type I, and a telegraph line adapter. 


TELE1 


115A 
83B3 


2701 

2702 
2703 


Telegraph adapter, type I. 

Telegraph terminal control, type I, and a telegraph line adapter. 


TELE2 


TWX 


2701 

2702 
2703 


Telegraph adapter, type II, and an appropriate modem. 
Telegraph terminal control, type II, and an appropriate modem. 


TELEW 


WTTA 


2701 

2702 
2703 


IBM World Trade Corporation telegraph adapter. 

IBM World Trade Corporation adapter and a telegraph line adapter. 



Figure 10. Terminal control or transmission adapters (ADAPTER) used to connect a telecommunications I/O device 
to a transmission control unit (TCU). 
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LINKLIB 

Optional for: 
complete 
nucleus 
I/O device 

The LINKLIB macro instruction is used to add user-written routines, in load-module form, to 
the link library (SYS 1. LINKLIB) in the new system. Before these load modules can be in- 
cluded in the link library, they must be members of a partitioned data set. This data set must 
have been cataloged as SYS 1 .name in the generating system. Although the MEMBERS and 
RESIDNT parameters are optional, at least one must be specified if this macro instruction is 
included. 

You may specify, at your option, those routines written by you that are reentrant and that are 
to be added to the list of modules that will become a part of the system's link pack area 
(SYS1.LPALIB). 

For a nucleus generation, members can be added to or deleted from SYS 1. LINKLIB. If you 
want the same members included that were included in the last complete system generation, 
you must respecify them. 

For an I/O device generation, members can be changed or deleted from SYS1. LINKLIB but they 
cannot be added. If you want the same members included that were included in the last com- 
plete system generation, you must respecify them. 



LINKLIB [MEMBERS=(/7ame [darnel ...)] 

PDS=SYS1./73/r>e 
[RESIDNT=(A7aA77e [,name] . . .)] 



Parameter Subparameter 

MEMBERS= name 



PDS= 



SYSl.name 



RESIDNT= name 



Explanation 

specifies the member(s) to be added to the system 
link library. 

specifies the partitioned data set that contains the 
load-module routines to be added. The name can- 
not exceed 8 alphameric characters. The first 
character must be alphabetic. 

specifies the member or members to be added to 
SYS1. LINKLIB and to the IEAFIX01 list of 
members that will become part of the resident 
portion of the link pack area. 

MEMBERS and RESIDNT are mutually exclu- 
sive. A name appearing as a value in either of 
these parameters must not appear as a value in 
the other. The total number of names 
(MEMBERS and RESIDNT) must not exceed 20. 
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Example: This macro specifies that IOSMAIN, IOSAA, and IOSA1 , members of the partitioned 
data set SYS 1 . USERLINK, are to be included in SYS 1 . LINKLIB in the new system. 

LINK LINKLIB PDS=SYS1 .USERLINK, X 

MEMBERS- ( IOSMAIN , IOSAA , IOSAl ) 



70 OS/VS2 System Generation Reference 



LOADER 

Optional for: 
complete 

Not applicable for: 

nucleus 

I/O device 

The LOADER macro instruction specifies the options to be included in the loader processing 
program. This macro instruction is optional. If it is specified, it can appear only once in the 
input deck. If it is not specified, the default values are assumed. 

Information on the loader program can be found in OS/VS Linkage Editor and Loader. 



LOADER [UB=ilib ddname) ] 

1 SYSLIB J 

[ LIN= (in ddname ) ] 
1 SYSLIN J 

[PARM= (option [, option] 

[PR I NT= (print ddname) ) 
I SYSLOUT J 

[SIZE= (size)] 
|128f 



.)] 



Parameter 
LIB= 



LIN= 



PARM= 



Subparameter 

library ddname 
SYSLIB 



input data 
set ddname 
SYSLIN 



PRINT 

NOPRINT 

NOMAP 

MAP 



Explanation 

specifies the ddname of the library that will be 
searched to resolve external references. If this 
parameter is omitted, SYSLIB is used. 

specifies the ddname of the primary input data set 
that will contain the input to the loader program. If 
this parameter is omitted, SYSLIN is used. 

specifies the options that will be used by the loader 
program. The following options can be listed in any 
order. If this parameter is not specified, the under- 
lined values will be used. 

specifies that the diagnostic messages and the map of 
external references will be placed on the data set 
specified by the PRINT parameter of this macro 
instruction. 

specifies that neither diagnostic messages nor the 
map of external references will be produced. 

specifies that the map of external references will not 
be produced. 

specifies that the map of external references will be 
produced on the data set specified by the PRINT 
parameter of this macro instruction. 
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Parameter 

PARM= 

(Continued) 



Subparameter 

MAP 

(Continued) 

NOLET 



LET 



CALL 



NOCALL 



NORES 



RES 



PRINT= 



SIZE= 



print ddname 
SYSLOUT 



size 
128 



Explanation 

If you specify this subparameter, the PRINT sub- 
parameter of the PARM parameter must also be 
specified. 

specifies that execution of the loaded program will 
not be attempted when a severity 2 error occurs 
during loading. 

specifies that execution of the loaded program will be 
attempted when a severity 2 error occurs during 
loading. 

specifies that the partitioned data set specified in the 
LIB parameter will be searched for any unresolved 
external references that remain after the input to the 
loader has been processed. 

specifies that the partitioned data set specified in the 
LIB parameter of this macro instruction will not be 
searched. 

specifies that the link pack area will not be 
searched. 

specifies that an automatic search of the link pack 
area is to be made. This search is always made after 
processing the primary input data set (LIN=ddname) 
but before searching the SYSLIB data set 
(LIB=ddname). If you specify this subparameter, 
CALL must also be specified in the PARM parameter 
of this macro instruction . 

is the ddname of the data set used for the map of 
external references and diagnostic messages. If this 
parameter is omitted, SYSLOUT is assumed. 

specifies the amount of virtual storage required by 
the loader program to hold its own buffers, tables, 
and the problem program. You specify a decimal 
number from 2 to 1024, indicating the number of IK 
blocks required. If this parameter is omitted, 128 is 
assumed. 



Example: This macro selects the options for the loader. The amount of virtual storage needed 
is 128K bytes. The input data set is SYSLIN, the output data set is SYSLOUT, and the external 
reference library is SYSLIB. Diagnostic messages and the map of external references will be 
placed on the SYSLOUT data set. Default values are assumed for the CALL and NORES 
subparameters. 



LOADER LOADER LIN=SYSLIN,LIB=SYSLIB, 
PRINT=SYSLOUT,SrZE=128, 
PARM= (PRINT, MAP) 



X 
X 



72 OS/VS2 System Generation Reference 



LPALIB 

Optional for: 

complete 

nucleus 

Not applicable for: 
I/O device 

The LPALIB macro instruction is used to add user-written routines, such as type 3 or 4 SVCs, 
in load module form, to the link pack area (SYS 1. LPALIB). Additionally, you may specify 
those user-written routines that are to be added to the resident portion of the link pack area. 

Before the load modules can be included in SYS 1 .LPALIB, they must be members of a parti- 
tioned data set. This data set must have been cataloged as SYS 1 .name in the generating 
system. 

If type 3 or 4 SVCs are specified, an SVCTABLE macro must also be specified. 

For a nucleus generation, members can be added to or deleted from SYS1 .LPALIB. If you 
want the same members included that were included in the last complete system generation, 
you must respecify them. 

For additional information on user-written routines, refer to OS/VS2 Planning and Use Guide. 



LPALIB [MEMBERS= (name [, name] . . .)] 

PDS=SYS1.name 
[RESIDNT=(/?a/7?e [,name] . . .)] 



Parameter Subparameter 

MEMBERS= name 



PDS= 



RESIDNT= 



SYSl.name 



name 



Explanation 

specifies the member or members to be added to 
SYS 1. LPALIB. 

specifies the partitioned data set that contains the 
load module routines to be added to SYS 1. LPALIB. 
The name cannot exceed 8 alphameric characters. 
The first character must be alphabetic. 

specifies the member or members to be added to 
SYS 1. LPALIB and to the IEAFIX01 list of members 
that will become part of the resident portion of the 
link pack area. 

MEMBERS and RESIDNT are mutually exclusive. A 
name appearing as a value in either of these param- 
eters must not appear as a value in the other. The 
total number of names (MEMBERS and RESIDNT) 
must not exceed 20. 
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Example: This macro specifies that two user-written accounting routines and two user-written 
SVC routines, members of SYS1.USERLIB, are to be included in SYS1.LPALIB and to the 
list of members that are to be included in the resident portion of the link pack area. 



USERLIB LPALIB PDS=SYS1.USERLIB, X 

MEMBERS= (ACCT1 , ACCT2 ) , X 

RESIDNT= (IGC248 , IGC249) 
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MACLIB 

Optional for: 
complete 

Not applicable for: 

nucleus 

I/O device 

The MACLIB macro instruction is used to exclude groups of macro definitions from the macro 
library of the new VS2 system. This macro instruction is optional. If it is omitted, the macro 
library is used in its entirety. 



MACLIB 



EXCLUDE= {option [,option] . . .) 



Parameter Subparameter 

EXCLUDE= 



BTAM 
GPS 
OCR 
TCAM 



TSO 



Explanation 

specifies groups of macro definitions to be excluded 
from the new system's macro library (SYS1. MACLIB). 
These values can be listed in any order. 

specifies that the macro definitions used for BTAM 
are to be excluded. 

specifies that the macro definitions used for graphics 
programming services (GPS) are to be excluded. 

specifies that the macro definitions used for optical 
character readers are to be excluded. 

specifies that the macro definitions used for TCAM 
are to be excluded. If the TSO macro is specified, 
TCAM will not be excluded even if it is specified in 
this macro instruction. 

specifies that the macro definitions used for TSO are 
to be excluded. 



Example: This macro specifies that the BTAM macro definitions are to be excluded from the 
macro library. 



MACLIB 



MACLIB 



EXCLUDE=(BTAM) 
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PAGE 

Required for: 
complete 
nucleus 
I/O device 

The PAGE macro instruction is used to provide the nucleus initialization program (NIP) with 
the information needed to allocate space to the page data sets. Up to sixteen page data sets 
may be defined. You must specify a PAGE macro for each data set required. Valid devices 
are: 2305-1, 2305-2, 2314/2319, 3330. (The 2314 and 2319 are considered the same device 
type.) 

The parameter values specified for the PAGE macro are placed in the IEASYS00 list in 
SYS1.PARMLIB during Stage II. Because of this, you may redefine page data sets at IPL, 
or after system generation, using the IEBUPDTE utility program. 

Specifications for the page data sets may be added to or deleted from the system in a nucleus 
or I/O device generation. 

For information about paging, refer to OS/VS2 Planning and Use Guide. For information on 
the size of page data sets, refer to OS/VS2 Storage Estimates. 



PAGE [LPA=iYES)l 

(NQ/ 

!BLK 
TRK 
CYL 
MAX 

[TYPE=/s) 1 




& 



[ (UMl=address 
\ VO\-NO=volume serial 



Parameter Subparameter Explanation 

LPA= specifies that the device being specified is to contain 

the pageable link pack area. If LPA is not specified 
in any PAGE macro instruction, the first PAGE 
macro will be assumed to contain the pageable link 
pack area. 

YES specifies that this device will contain the pageable 

link pack area. YES may only be specified in one 
PAGE macro. 

NO specifies that this device will not contain the pageable 

link pack area. 

SIZE= specifies the size of the page data set. The space that 

will be allocated will be contiguous. If this parameter 
is not specified, MAX is used. 
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Parameter 


Subparameter 


SIZE= 


(bLK^ 


(Continued) 


<TRK> 




(cyl) 




number 




MAX 



TYPE= 



UNIT= 



address 



VOLNO= 



volume serial 



Explanation 

specifies that space is to be allocated in 4K blocks. 

specifies that space is to be allocated in tracks. 

specifies that space is to be allocated in cylinders 

specifies the number of blocks, tracks, or cylinders to 
be allocated. 

specifies that the largest contiguous extent on the 
selected volume be used for the page data set. For 
storage estimates for page data sets, refer to OS/VS2 
Storage Estimates. 

specifies the type of auxiliary storage device that is to 
be used for paging operations. 

specifies a primary device is to be used for paging 
operations. 

specifies a secondary device is to be used for paging 
operations. 

Information about primary and secondary auxiliary 
storage devices is in OS/VS2 Planning and Use Guide. 

specifies the address of the device that is to contain 
the page data set. This device must also be specified 
in an IODEVICE macro instruction. IOREQUE= 
PRIORITY should also be specified in an IODEVICE 
macro for the device that is to contain the page data 
set. If PRIORITY is not specified, performance will 
be degraded. 

specifies the volume serial number of the volume that 
is to contain the page data set. 

If UNIT or VOLNO is not specified, VOLNO=PAGEnn 
is used (where 00 < nn < 15) to specify the first 
through sixteenth page data set. 



Example: This macro specifies a secondary page data set (TYPE=S). The unit address of this 
page data set is 430 and the size is to be the largest contiguous extent available on the selected 
volume. 



PAGE 



SIZE=MAX,TYPE=S,UNIT=430 
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RESMODS 

Optional for: 

complete 

nucleus 

Not applicable for: 
I/O device 

The RESMODS macro instruction is used to add your own routines, in load module form, to 
the nucleus (member name IEANUC01). Before these routines can be included, they must be 
members of a partitioned data set. This data set must have been cataloged as SYS 1. name in 
the generating system. 

A RESMODS macro instruction must be specified for each type 1 or type 2 user-written SVC 
routine to be included in the new system. If type 1 or 2 SVCs are specified, an SVCTABLE 
macro must also be specified. 

For a nucleus generation, sufficient space must have been allocated to SYS 1 .NUCLEUS in the 
previous generation. Members may be added to or deleted from SYS 1. NUCLEUS. If you want 
the same members included, you must respecify this macro with the same parameters and sub- 
parameters and you must also respecify the SVCTABLE macro instruction. 



RESMODS MEMBERS=(/7ame [,name\ . . .) 

PDS=SYS1./?ame 



Parameter 
MEMBERS= 



Subparameter 

name 



PDS= 



name 



Explanation 

specifies the name of the member of the partitioned 
data set to be included in the nucleus. The name 
must be 1 to 8 alphameric characters, the first of 
which is alphabetic. A maximum of ten load modules 
can be included in the nucleus. 

For further information on writing your own SVC 
routines, refer to the OS/VS2 Planning and Use 
Guide. 

specifies the partitioned data set that contains the 
load modules to be included in the nucleus. The 
name must be 1 to 8 alphameric characters, the 
first of which is alphabetic. 



Example: This macro specifies that two user-written SVC routines that are members of the 
partitioned data set SYS1.USERLIB are to be included in the nucleus (SYS1. NUCLEUS). 

RESMODS RESMODS PDS=SYS1.USERLIB, 

MEMBERS=(IGC240,IGC241) 
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SCHEDULR 

Required for: 
complete 
nucleus 
I/O device 

The SCHEDULR macro instruction specifies the job scheduler and master scheduler options. 
This macro instruction is required. 

For a nucleus generation, only WTOBFRS and REPLY can be changed. All other parameters 
must be respecified exactly as they were during the last complete system generation. 

For an I/O device generation, the CONSOLE and ALTCONS parameters can be changed. The 
console and alternate console addresses may be changed. No other parameters can be changed 
and they must be respecified exactly as they were during the last complete system generation. 
The addresses specified in the STARTR and STARTW parameters must be the same as those 
specified in the last complete system generation, but they can be changed at IPL. 



SCHEDULR [ALTCONS= (address )] 

\ (I-address, O-address) ) 

[AREA=(A7A)[ / A7/7l...)] 

[BCLIVnW/nfegre/-)] 
1 l00 / 



CONSOLE= (address 



\ (I-address , O-address) 



} 



[ESV= (SMF)] 
I CON ) 

[EVA=(/7 lf A7 2 )l 

[HARDCPY=(( address ) 
1 SYSLOG I 

(, (routing-code [, routing-code] . . .)) 
\ Mk J 

[,(CMDS )])] 
< INCMDS > 
(STCMDS) 

[\MTQBF=number] 

\OC=address 

* [JOBQFMT= j number )] 

*[JOBQLI\/nW number) ] 
160 / 

* [JOBQTMT= ( number )] 

\60 / 

* [ JOBQWTP= ( number ) ] 



*These parameters may be overridden by the operator during IPL. 
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[OLD\NTOR=[rou ting-code [.routing-code] . . .)] 
[PFK=/v?l 

[REPLY= ( number) ] 
110 f 

[ROUTCDE= Routing-code [/outing-code] . . .)] 

*[STARTI=(AUTO \] 
( MANUAL ) 

* [ST ARTR=(A-address[y -serial] [,D-dsname] )] 

* [START\N={A-address [ M-serial] [ ,D-dsname] )] 

[VLMOUNT=AVR ] [ ,TAVR= ( 200 ) ] 

?556> 
(8po) 

[\NTLBFRS= (number \] 
[WTLCLSS= (c/assname\ ] 
[WTOBFRS=number] 



*These parameters may be overridden by the operator during IPL. 



Parameter Subparameter 

ALTC0NS= address 



I-address 
O-address 



AREA= 



nn 



Explanation 

specifies the unit address of a device having input and 
output capability that is to be used as an alternate 
console. 

specifies, for a composite console, the unit address of 
an input device. 

specifies, for a composite console, the unit address of 
an output device. 

Each unit address used must be the same as that 
specified for the device in an IODEVICE macro in- 
struction. The devices that can be used are listed in 
Figure 10. 

A device specified as a part of a composite console 
cannot be specified in any other way (as a single 
device or as a part of a composite console with a 
different companion device). However, the same 
combination may be repeated more than once in the 
SECONSLE macro instruction as an alternate console. 

The device specified as an alternate console in this 
parameter must also be specified as a secondary con- 
sole in the SECONSLE macro. 

specifies the dimensions of the display areas to be 
set aside for status displays on the display screen of 
the console specified in the CONSOLE parameter of 
the SCHEDULR macro instruction. 
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Parameter 


Subparameter 


AREA= 


nn 


(Continued) 


(Continued) 



BCLMT= 



number 
100 



CONSOLE= address 

I-address 
O-address 



SCHEDULR 

Explanation 

The value specified must be a decimal number equal 
to the number of display screen lines to be in the dis- 
play area. Each nn defines one display area of the 
size indicated. The first nn defines the bottommost 
display area on the screen (the bottom lines of the 
message area). Subsequent nn's define areas stacked 
above the bottommost area. The minimum specifi- 
cation is 4 lines. The maximum specification for all 
areas is: 

47 if a 2250 is used 
8 if a 2260 is used 
30 if a 3066 is used 
19 if a 3158 is used 
19 if a 3277 Model 2 is used 

The default is a single area with a length of: 

14 if a 2250 is used 
8 if a 2260 is used 
14 if a 3066 is used 
14 if a 3 158 is used 
14 if a 3277 Model 2 is used 

This parameter is invalid for any other consoles. For 
further information about display consoles, refer to 
Operator's Library: OS/ VS2 Display Consoles. 

is an integer from 1 to 1000 that specifies the number 
of 130-byte records that will be set aside for broad- 
cast messages in the SYS1.BRODCAST system data 
set. If this parameter is specified, the SYS1 .BRODCAST 
system data set should be specified in a DATASET 
macro instruction. If this parameter is not specified, 
a value of 100 is used. 

specifies the unit address of a console device, having 
input and output capability, to be used as the master 
console. A master console must always be specified. 

specifies, for a composite console, the unit address of 
an input device. 

specifies, for a composite console, the unit address of 
an output device. 

Each unit address used must be the same as that speci- 
fied for the device in an IODEVICE macro instruction. 
The devices that can be used are listed in Figure 10. 

A device specified as a part of a composite console 
cannot be specified in any other way (as a single de- 
vice or as a part of a composite console with a different 
companion device). 
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Parameter Subparameter 

CONSOLE= O-address 
(Continued) (Continued) 



ESV= 



CON 



SMF 



EVA= 



ni,n 2 



Explanation 

If a graphics device will be active as a console, a de- 
vice that produces printed output must also be 
specified. 

If a device is specified as the master console (in the 
CONSOLE parameter of the SCHEDULR macro), it 
cannot be specified as the secondary console (in the 
CONSOLE parameter of the SECONSLE macro); it 
can, however, be specified again as an alternate con- 
sole in the SECONSLE macro. 

specifies the destination of volume error statistics 
(ESV) records. If this parameter is not specified, 
CON is used. 

specifies that an abridged version of the records is to 
be constructed and put on the console. 

specifies that the records are to be constructed and 
written on the SYS 1. MANX or SYS 1. MANY system 
data sets. 

specifies the use of error volume analysis (EVA) and 
the number of temporary read and write errors that 
will cause an ESV message to be printed on the con- 
sole. If this parameter is not specified, EVA will not 
be included in the new system. 

are integers from 1 to 255. 

n x is the number of temporary read errors that will 
cause an ESV message to be printed on the 
console. 

n 2 is the number of temporary write errors that 
will cause an ESV message to be printed on the 
console. 



HARDCPY= 



specifies that a hard-copy log will be used to record 
operator commands, system commands and responses, 
and write-to-operator (WTO and WTOR) messages. 
(Control (K) commands, which control console func- 
tions rather than system functions, are not recorded 
on the hard-copy log but are recorded in the SYSLOG 
data set.) If this parameter is not specified, SYSLOG, 
ALL, and NOCMDS are used. For information about 
operator communication with the system, the hard- 
copy log, and the system log, refer to Operator's 
Library: OS/VS Console Configurations and OS/VS 
Supervisor Services and Macro Instructions. 

The subparameters for HARDCPY are positional and 
must be coded in the sequence shown in the macro 
instruction format. For any subparameter omitted, a 
comma must be written to indicate its absence. For 
example, HARDCPY=(,ALL,CMDS) indicates the 
absence of the unit address subparameter. 
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Parameter 

HARDCPY= 

(Continued) 



Subparameter 
SYSLOG 

address 



ALL 



routing code 



CMDS 



INCMDS 



STCMDS 



INITQBF= number 



SCHEDULR 

Explanation 

specifies that the data that is supposed to go to the 
hard-copy log will go to the system log. 

specifies the unit address of a device with at least out- 
put capability to be used as the hard-copy log device. 
(See Figure 10 for a list of the devices that can be 
used.) The unit address specified for the device must 
also be specified for that device in an IODEVICE 
macro instruction. This device must also be specified 
in either the CONSOLE parameter of the SCHEDULR 
macro or a SECONSLE macro. 

A graphics device cannot be specified as the hard-copy 
log device. 

specifies that all write-to-operator (WTO and WTOR) 
messages are to be put on the hard-copy log. 

is a number from 1 to 16 that designates the routing 
code that the hard-copy log is authorized to receive 
for each operator's console specified in the CONSOLE 
parameter of the SCHEDULR and SECONSLE macro 
instructions. 

For information on routing and descriptor codes, 
refer to OS/VS Message Library: Routing and 
Descriptor Codes. 

specifies that operator and system commands, re- 
sponses and status displays (static and time-interval 
updated) are to be written on the hard-copy log. 

specifies that operator and system commands and 
responses (but not status displays) are to be written 
on the hard-copy log. 

specifies that operator and system commands, re- 
sponses, and status displays (except time-interval 
updated status displays) are to be written on the 
hard-copy log. 

If neither CMDS, INCMDS, nor STCMDS is specified, 
no operator or system commands or responses will be 
put on the hard-copy log. 

specifies the number of 1024-byte buffers in real stor- 
age that will hold logical tracks from SYS1.SYSJOBQE. 
The number specified must be a decimal integer from 
to 255. 

Information about the storage required by 
SYS1.SYSJOBQE can be found in OS/VS2 Storage 
Estimates. 
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Parameter Subparameter 

IOC= address 



JOBQFMT= number 
12 



JOBQLMT= 



number 
60 



JOBQTMT= 



number 
60 



JOBQWTP= number 

2 



OLDWTOR= routing code 



Explanation 

is the unit address of an integrated operator console. 
The value specified must be the unit address of a 
3066, 3158, 3210, or 3215 console. This parameter 
must be specified. 

specifies the number of 176-byte queue records that 
can be written on a track allocated to 
SYS1 .SYSJOBQE. The number specified is an 
integer from 5 to 255. This number represents the 
total number of 1 76-byte records on each track. 
This value can be changed at IPL when the system 
is loaded. If this parameter is not specified, 12 is 
used. Refer to OS/VS2 Storage Estimates for 
information on determining this value. 

specifies the number of 176-byte records in 
SYS1. SYSJOBQE to be reserved for each initiator 
started. The number specified is an integer from 60 
to 9999. This value can be changed at IPL when the 
system is loaded. If this parameter is not specified, 
60 is used. Refer to OS/VS2 Storage Estimates for 
information on determining this value. 

specifies the number of 176-byte records in 
SYS 1. SYSJOBQE to be reserved for the termination 
of jobs that require more records for initialization 
than those specified in JOBQLMT. The number 
specified is an integer from 60 to 9999. This value 
can be changed at IPL when the system is loaded. If 
this parameter is not specified, 60 is used. Refer to 
OS/VS2 Storage Estimates for information on deter- 
mining this value. 

specifies the number of 161-byte records in 
SYS 1. SYSJOBQE that the write-to-programmer rou- 
tine can use for messages during a job. The number 
specified is an integer from 2 to 20. This value can be 
changed at IPL when the system is loaded. 

If this value is not specified, 2 is used. Refer to OS/VS2 
Storage Estimates for information on determining this 
value. 

is a number from 1 to 16 that specifies the routing 
code to be assigned to all write-to-operator (WTO and 
WTOR) messages that do not already have routing and 
descriptor codes. 

If this parameter is omitted, the master console will 
receive the WTO and WTOR messages that do not 
have routing and descriptor codes. 

For information on routing and descriptor codes, 
refer to OS/ VS Message Library: Routing and 
Descriptor Codes. For information on specifying WTO 
and WTOR macros, refer to OS/VS Supervisor Ser- 
vices and Macro Instructions. 
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Parameter 

PFK= 



Subparameter 

number 



REPLY= 



number 
10 



ROUTCDE= routing code 



STARTI= 



AUTO 



SCHEDULR 

Explanation 

specifies that the console is to have programmed- 
function-keyboard (PFK) command entry and/or light- 
pen command entry. This parameter is valid only for 
a 2250, 3158 or 3277 Model 2 that is specified as a 
console with input-output capability or as the input 
half of a composite console. The number specified is 
a decimal number from 1 to 12 that indicates: 

• the number of PFK keys that the operator can 
associate with commands after IPL (2250 or 3277 
Model 2), or 

• the number of light-pen-detectable numerical 
indicators in the PFK line of the screen that the 
operator can associate with commands after 
IPL (2250, 3158, or 3277 Model 2). 

If the specified console has both a PFK and a light pen, 
both methods of command entry will be made available 
when the PFK parameter is specified. 

If this parameter is specified, space must be allocated 

forSYSl.DCMLIB. 

If this parameter is specified for a 2250, either the 

LIGHTPEN or PRGMKYBD features, or both, must 

be specified in an IODEVICE macro instruction. 

If this parameter is specified for a 3277 Model 2, 
either the SELPEN or programme d-function keyboard 
(KB78KEY) features, or both, must be specified in 
an IODEVICE macro instruction. 

The SELPEN feature must be specified for the 3158. 

Information on the programme d-function keyboard, 
selector pen, and light pen features can be found in 
Operator's Library : OS/ VS2 Display Consoles. 

specifies the number of reply queue elements to be 
used by the WTOR routines. Each reply queue element 
is 24 bytes. If this parameter is not specified, 10 is 
assumed. 

is a number from 3 to 16 that specifies the additional 
routing codes the master console can receive. 

Routing codes 1 and 2 are always automatically 
assigned for use by the master console (see OS/VS 
Message Library: Routing and Descriptor Codes). 

specifies whether a START INIT command is to be 
executed automatically after each IPL. This command 
can be overridden by the operator after IPL. (Refer to 
Operator's Library: OS/VS2 Reference for this infor- 
mation.) If this parameter is not specified, MANUAL 
is used. 

specifies that the command is to be executed 
automatically 
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Parameter 

STARTI= 

(Continued) 

STARTR= 



Sub parameter 

MANUAL 



A-address 

V-serial 

D-dsname 



STARTW= 



TAVR= 



A-address 

V-serial 

D-dsname 



200 
556 
800 



VLMOUNT= AVR 



WTLBFRS= number 
4 



Explanation 

specifies that it is not to be executed automatically. 

specifies that a START RDR command is to be 
executed automatically for a device each time the 
new system is loaded after each IPL. This command 
can be overridden by the operator after IPL. (Refer 
to Operator's Library: OS/VS2 Reference for this 
information.) 

is the unit address of the input device to be started. 

When the device to be started is on tape or disk: 
specifies the volume serial number of the labeled 
volume associated with the device. 

specifies the name of the data set associated with the 
device to be started. The data set name can be from 
1 to 8 characters; the first character must be 
alphabetic. 

specifies that a START WTR command is to be 
executed automatically for a device each time the 
new system is loaded after IPL. This command can 
be overridden by the operator after IPL. (Refer to 
Operator's Library: OS/VS2 Reference for this 
information.) 

is the unit address of the output device to be started. 

When the device to be started is tape or disk: 
specifies the volume serial number of the labeled 
volume associated with the device. 

specifies the name of the data set associated with the 
device to be started. The data set name must be from 
1 to 8 characters, the first character must be alphabetic. 

specifies the standard density for 7-track magnetic 
tape volumes used with automatic volume recognition 
(AVR). If this parameter is not specified, 800 BPI 
is used. 

This parameter is specified only if the VLMOUNT= 
AVR parameter is coded. 

specifies automatic volume recognition. For informa- 
tion about AVR, refer to OS/VSJCL Services. 

specifies the number of buffers that will be used as 
temporary storage areas for write-to-log (WTL) mes- 
sages that will be written on the SYS1 .SYSVLOGX 
or SYS1.SYSVLOGY system data sets. The number 
specified is an integer from 4 to 255. Although each 
system has different system log requirements, an 
optimum number for best log performance is from 
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Parameter 

WTLBFRS= 

(Continued) 



Sub parameter 

number 

(Continued) 



WTLCLSS= 



WTOBFRS= 



classname 
L 



number 



SCHEDULR 

Explanation 

10 to 15. If this parameter is not specified, 4 is 
assumed. 

The number you specify will be multiplied by 148 
(which is the maximum size of a WTL message) to 
determine the size of the buffer area. No matter 
what value is specified, the size of the area will not be 
greater than twice the track size of the device type 
for which SYS 1 . SYSVLOGX and SYS 1 . SYSVLOGY 
are cataloged. For information on WTL messages, 
refer to OS/VS Supervisor Services and Macro 
Instructions. 

specifies the classname to be used as a default for 
SYSOUT write-to-log messages. Classname is a letter 
from A to Z or a number from to 9. If this param- 
eter is not specified, L is used. 

specifies the number of buffers to be used by the 
write-to-operator (WTO) routines. The number speci- 
fied is an integer greater than or equal to 4. The num- 
ber specified should at least be equal to four times the 
number of initiators expected to be active at any one 
time. Each buffer will be 168 bytes. 

If the value specified is less than two buffers per con- 
sole, then the specified value is ignored and two 
buffers per console are assigned. If this parameter is 
not specified, two buffers are assigned for each opera- 
tor's console specified in the SECONSLE macro 
instruction. 

For information on communiation between the 
operator and the system, refer to OS/VS Supervisor 
Services and Macro Instructions. 
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Device 


Model 


ALTCONS/ 

CONSOLE 

address 


I-address 


O-address 


HARDCPY 
address 


Notes 


1052 


7 


X 


X 


X 


X 


Console keyboard- 
printer. 

Can only be speci- 
fied when attached 
through the 2150 
adapter. 


1403 








X 


X 


Printer (note 1) 


1443 


N1 






X 


X 


Printer (note 1 ) 


2250 




X 


X 


X 




Display unit 
(note 2) 


2260 


1 


X 


X 


X 




Display station 
(notes 1 and 3) 


2501 






X 






Card reader 


2520 


B1 




X 






Card reader punch 


2540R 






X 






Card reader 


2740 


1 


X 


X 


X 


X 


Communication 
terminal (note 3) 


3066 




X 


X 


X 




System console. 
May only be speci- 
fied in a 

S370/165Hor168 
system configura- 
tion, and can only 
appear once in the 
system as a master 
or secondary con- 
sole (note 3). 


3158 




X 


X 


X 




Display unit (notes 
1 and 3) 


3210 




X 


X 


X 


X 


Console print 
keyboard 


3211 








X 


X 


High-speed printer. 
The universal char- 
acter set is included, 
(note 1) 


3213 








X 


X 


Printer 


3215 




X 


X 


X 


X 


Console print 
keyboard 


3277 

______ 


1 






X 




Display unit. 
May only be speci- 
fied as an O-address 
and must only be 
specified in the 
SECONSLE macro. 



Figure 1 1 (Part 1 of 2). Console and alternate console support. This figure lists the devices 

that can be used as consoles and alternate consoles in the SCHEDULR 
and SECONSLE macro instructions. 
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SCHEDULR 



Device 


Model 


ALTCONS/ 
CONSOLE 
address 


I-address 


O-address 


HARDCPY 
address 


Notes 


3277 


2 


X 


X 


X 




Display unit 
(note 3) 


3284 


1 






X 


X 


Printer (note 1) 


3284 


2 






X 


X 


Printer (note 1) 


3286 


1 






X 


X 


Printer (note 1) 


3286 


2 






X 


X 


Printer (note 1) 


3505 






X 






Card reader 


3525 






X 






Card punch. Must 
have read feature. 


Notes: 

1 . These devices may be specified as O-address only consoles in the SECONSLE macro instruction. 

2. Refer to Figure 7 for IODEVICE specifications and parameters required when this device is used as 
an operator's console. The GRAPHICS macro instruction is required for a 2250 Model 3. 

3. Refer to Figure 7 for IODEVICE specifications and parameters required when this device is used as 
an operator's console. 



Figure 1 1 (Part 2 of 2). Console and alternate console support. This figure lists the devices 

that can be used as consoles and alternate consoles in the SCHEDULR 
and SECONSLE macro instructions. 
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Example: This macro specifies the options for the scheduler. The following options are 
specified: 

The system start commands are to be issued manually 

Automatic volume recognition 

The density for 7-track tapes is 200 BPI 

The output class for the system log is SYSOUT=D 

Twelve queue records per logical track 

SYS1.BRODCAST is to have room for 100 notice messages 

The console address is 009 

The alternate console addresses are 00C for input and 00E for output 

Ten reply queue requests will be permitted 

The integrated operator console address is 009 

The system log will be the hard-copy log 

All WTO messages will be written on the hard-copy log 

Status displays will not be written to the hard-copy log 

Operator commands and responses will be written to the hard-copy log. 



SCHEDULR SCHEDULR CONSOLE=009 , X 

ALTCONS=(I-00C,O-00E) , STARTI=MANUAL , X 
REPLY=10,HARDCPY=(SYSLOG,ALL,INCMDS) ,X 
BCLMT= 100, VLMOUNT=AVR , TAVR= 200, X 
WTCLSS=D , ESV=NO , IOC=0 9 
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SECONSLE 

Optional for: 
complete 
nucleus 
I/O device 

The SECONSLE macro instruction is used to specify secondary support for the standard 
multiple console support function. This macro instruction is optional. It must, however, be 
specified if the ALTCONS parameter of the SCHEDULR macro instruction is specified. 

For a nucleus generation, this macro instruction must be specified if it was specified in the last 
complete system generation. The same parameters and subparameters must be coded. If 
the SECONSLE macro instruction was not specified in the last complete generation, it cannot 
be specified. 

For an I/O device generation, this macro instruction must be specified if it was specified in the 
last complete system generation. This macro instruction can be used to add, delete, or change 
the secondary console specifications. If this macro instruction was not specified in the last 
complete generation, it cannot be specified. 

The alternate console for the master console that is specified in the ALTCONS parameter of the 
SCHEDULR macro instruction must be used in the CONSOLE parameter of this macro 
instruction. 

This macro instruction must be used to specify each additional secondary console. 

You must specify a SECONSLE macro instruction for each secondary console to be included 
in the new system. A maximum of 3 1 secondary consoles can be specified. If more are speci- 
fied, the system generation process is terminated. 

Each device specified in an ALTCONS parameter of a SCHEDULR or SECONSLE macro 
instruction must also be specified in a CONSOLE parameter of a SCHEDULR or SECONSLE 
macro instruction. 



SECONSLE [ALTCONS= / address ) ] 

) O-address / 

( (l-address,0-address) ) 

[AREA=(w?[,wi]...)] 

CONSOLE= (address \ 

) O-address > 

( (l-address,0-address) ) 

[PFK=A7Aj] 

[ROUTCDE=(ALL ll 

\ ( routing code [ .routing code] . . . ) ; 

[USE=(SD)1 
(MS J 

[\/ALDCMD= (command code [, command code] . . .)] 
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Parameter 
ALTCONS= 



Subparameter 

address 

I-address 

O-address 



AREA= 



nn 



Explanation 

specifies the address or addresses of the alternate 
console. 

is the unit address of an alternate console device that 
can be used for input and output. 

is the unit address of an input device for a composite 
console. 

is either the unit address of an output device for a 
composite console or the unit address of a console 
that can be used only for output. 

If this parameter is omitted, the master console speci- 
fied in the CONSOLE parameter of the SCHEDULR 
macro instruction is assigned as the alternate console. 

The device specified must also be specified in the 
CONSOLE parameter of either the SCHEDULR or a 
SECONSLE macro instruction. 

Each unit address used must be the same as that 
specified for the device in an IODEVICE macro 
instruction. Figure 1 1 lists the devices that can be 
used. 

A console that can be used only for output cannot be 
specified as the alternate console for a console that 
can be used for both input and output. 

A device specified as a part of a composite console 
cannot be specified in any other way (as a single 
device or as a part of a composite console with a 
different companion device). 

specifies the dimensions of the display areas to be 
set aside for status displays on the display screen of 
the console specified in the CONSOLE parameter of 
the SECONSLE macro instruction. 

The value specified must be a decimal number equal 
to the number of display screen lines to be in the 
display area. Each nn defines one display area. The 
first nn defines the bottom-most display area on the 
screen (the bottom lines of the message area). Sub- 
sequent nn's define areas stacked above the bottom- 
most area. The minimum specification is 4 lines. The 
maximum specification for all areas is: 

47 if a 2250 is used 
8 if a 2260 is used 

1 1 if a 2260 is used only for output (USE=SD) 
30 if a 3066 is used 
19 if a 3277 Model 2 is used 
23 if a 3277 Model 2 is used only for output 
(USE=SD) 
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SECONSLE 



Parameter Subparameter 

AREA= nn 

(Continued) (Continued) 



CONSOLE= 



address 

I-address 

O-address 



PFK= 



number 



Explanation 

The default values are: 

14 if a 2250 is used 
8 if a 2260 is used 

1 1 if a 2260 is used only for output (USE=SD) 
14 if a 3066 is used 
14 if a 3277 Model 2 is used 
(13, 10) if a 3277 Model 2 is used only for output 
(USE=SD) 

This parameter is invalid for any other console and is 
also invalid for a 2250, 2260, or 3277 Model 2 when 
USE=MS has been specified in the SECONSLE 
macro. For further information about display con- 
soles, refer to Operator's Library: OS/VS2 Display 
Consoles. 

specifies the address or addresses of the secondary 
console. 

specifies the unit address of the secondary console 
that can be used for input and output. 

is the unit address of an input device for a composite 
console. 

is either the unit address of an output device for a 
composite console or the unit address of a console 
that can be used only for output. 

Each unit address used must be the same as that speci- 
fied for the device in an IODEVICE macro instruction. 
For a list of the devices that can be used, see Figure 11. 

A device specified as a part of a composite console 
cannot be specified in any other way (as a single de- 
vice or as a part of a composite console with a 
different companion device). 

If a device is specified as the master console (in the 
CONSOLE parameter of the SCHEDULR macro), it 
cannot be specified as the secondary console (in the 
CONSOLE parameter of the SECONSLE macro); it 
can, however, be specified again as an alternate console. 

specifies that the console is to have programmed- 
function-keyboard (PFK) command entry and/or 
light pen command entry. This parameter is valid 
only for a 2250, 3158, or 3277 Model 2 that is 
specified as a console with input/ output capability 
or as the input half of a composite console. The 
number specified is a decimal number from 1 to 12 
that indicates: 

• the number of PFK keys that the operator can 
associate with commands after IPL (2250 or 
3277 Model 2), or 

Specifying the New System Control Program 95 



Parameter 

PFK= 

(Continued) 



Subparameter 

number 
(Continued) 



ROUTCDE= 



ALL 

routing code 



USE= 



SD 



MS 



VALDCMD= command code 



Explanation 

• the number of light-pen-detectable numerical 
indicators in the PFK line of the screen that the 
operator can associate with commands after IPL 
(2250, 3158, or 3277 Model 2). 

If the specified console has both a PFK and a light 
pen, both methods of command entry will be made 
available when the PFK parameter is specified. 

If this parameter is specified, space must be allocated 
forSYSl.DCMLIB. 

If this parameter is specified for a 2250, either the 
LIGHTPEN or PRGMKYBD features or both must 
be specified in an IODEVICE macro instruction. 

If this parameter is specified for a 3277 Model 2, 
either the SELPEN or programmed-function keyboard 
(KB78KEY) features, or both, must be specified in an 
IODEVICE macro instruction. 

The SELPEN feature must be specified for the 3158. 

Information on the programmed-function keyboard, 
selector pen, and light pen can be found in Operator's 
Library: OS/VS2 Display Consoles. 

specifies which routing codes the console will receive. 
If this parameter is not specified, no routing codes are 
assigned to this console. 

specifies that the console can receive all routing codes. 

is a number from 1 to 16 that designates which 
routing code will be recognized and accepted by this 
console. (Refer to OS/ VS Message Library: Routing 
and Descriptor Codes for additional information.) 

specifies the intended use of a 2260, 3277 Model 2, 
or 3158 display (CRT) console. 

If this parameter is not specified, full capacity is 
assumed. 

specifies that the console is to be used as an output- 
only console for status displays. 

specifies that the console is to be used as an output- 
only console to display operator messages. 

is a number from 1 to 3 that specifies which commands 
can be entered from this console. One or more num- 
bers may be specified to indicate which command 
groups can be entered from the console. For informa- 
tion on command groups, refer to Operator's Library: 
OS I VS2 Reference. 
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SECONSLE 

Example: This example specifies that a 3277 Model 2 at address 018 is to be used as a secondary 
console. A 2260 Model 1 at address 001 is to be used as the alternate console. (These devices 
and addresses were also specified in IODEVICE macros.) The status display areas are to have 
lengths of 7. No routing codes have been assigned to this console. 

SECON018 SECONSLE CONSOLE=018 , ALTCONS=001 , X 
AREA=(7,7) 
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SVCTABLE 

Optional for: 
complete 
nucleus 
I/O device 

The SVCTABLE macro instruction is used to specify the number, type, and function code of 
the user-written supervisor call (SVC) routines that are to be added to the new system. This 
macro may be specified more than once. 

Type 1 and 2 SVCs: For each type 1 or type 2 SVC, a corresponding member should be speci- 
fied in the RESMODS macro instruction. One member may contain more than one resident 
SVC routine. 

Type 3 and 4 SVCs: For each type 3 or type 4 SVC, a corresponding member should be speci- 
fied in the LPALIB macro instruction. Each member may contain only one SVC routine. 

Nucleus generation: An SVCTABLE macro instruction must be specified for each type 1 or 
2 SVC specified in the RESMODS macro instruction and for each type 3 or 4 SVC specified 
in an LPALIB macro instruction. 

I/O device generation: If this macro instruction was not used in the last complete generation, 
it cannot be specified for an I/O device generation. If it was specified, it must be respecified 
with the same operands. 



SVCTABLE 



operand [ ,operand ] 



Parameter Subparameter Explanation 

operand Each operand is written in the format shown below. 

Uppercase letters and hyphens must be coded as 
shown. 



SVC-nnn- ( Da ) ["_ { FCO 1 ^| 



( FCOO fj 



where: 



nnn specifies the SVC number as a decimal number 

D specifies that the SVC is being entered with 
interruptions disabled. 

E specifies that the SVC is being entered with 
interruptions enabled 

a specifies the SVC type as either 1, 2, 3, or 4 

El (type 1 SVC entered enabled) is an invalid param- 
eter. All type 1 SVCs must be entered disabled. 

FC01 indicates a function code of 01 is to be assigned 
to the SVC. This code will restrict the use of the SVC 
to authorized job steps. If this value is not specified, 
a value of FC00 is assumed making the SVC 
unrestricted. 
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Parameter Subparameter Explanation 

operand For additional information on the Authorized Pro- 

continued) gram Facility (APF), refer to OS/VS2 Planning and 

Use Guide. 

You must assign unique numbers (nnn) to your SVC 
routines. You should assign them in descending order 
starting with 255 and ending with 200 to avoid con- 
flict with the numbers assigned to IBM-written rou- 
tines. (For an example of adding a user-written SVC 
routine, refer to "Adding User-Written Routines to 
the System Control Program.") 

For information about SVCs and APF, refer to OS/VS2 
Planning and Use Guide. 

Example: This macro specifies the number and type of three user-written SVC routines. 
SVC255 is a type 1 SVC that is being entered with interruptions disabled. SVC254 is a 
type 4 SVC, SVC253 is a type 3 SVC and both are being entered with interruptions enabled. 
An authorization code (APF) was not specified so these SVCs are not restricted. 

SVCTABLE SVCTABLE SVC-255-D1 , SVC-254-E4 , X 

SVC-253-E3 
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TSO 

Optional for: 
complete 
nucleus 
I/O device 

The TSO macro instruction is used to specify a system with TSO. 

If the TSO macro is specified, TCAM is included in the system. 

For a nucleus or I/O device generation, this macro must be respecified if it was originally 
specified. The same parameters and subparameters must be coded. 



TSO 



[LOGLINE=(/V7te^er) ] 
110 f 

[LOGT\ME=i time)] 
(300 / 

[OUTCLS=( ( [c/assname 1] [,classname2] \)] 
\ X X ) 

[SUBMITQ=( number) ] 
(50 / 

[TSO AUX= ( number)] 



Parameter 
LOGLINE= 



LOGTIME= 



OUTCLS= 



SUBMITQ= 



Subparameter 

number 
10 



time 



classname 1 

classname 2 

number 
50 



Explanation 

specifies the number of lines that may be entered 
before an attempt to log on is automatically 
canceled. The number specified is an integer from 
1 to 16, 777, 215. If this parameter is not specified, 
a 10 is used. 

specifies the number of seconds you may wait without 
a terminal response during a LOGON. The number 
specified is an integer from 1 to 16, 777, 215. If this 
parameter is not specified, 300 seconds is used. 

specifies the class defaults for the OUTPUT command. 
The value must be specified as a letter from A to Z 
or a number from to 9. If this parameter is not 
specified, X is used for both classname values. 

is the background-message class default. 

is the printed-output class default. 

specifies the maximum number of logical tracks to be 
reserved in the system job queue for TSO jobs sub- 
mitted for background running. The value specified 
is an integer from to 9999. If this parameter is not 
specified, 50 is used. 
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Parameter 


Subparameter 


TSOAUX= 


number 








Explanation 

specifies the percentage of the first 4096 pages of 
external page storage to be made available to TSO. 
The value specified is an integer from to 100. If 
this parameter is not specified, is used. 

Example: This macro specifies a printed-output class of A, that 600 seconds may elapse before 
LOGON issues a message, that 5 lines may be entered before a LOGON attempt is canceled, and 
that 100 logical tracks are to be reserved for TSO foreground -initiated-background (FIB) jobs in 
the system job queue. The default value of X is used for the background message class. No 
additional external page storage will be used. 

TSODF TSO LOGTIME=600,LOGLINE=5,SUBMITQ=100, X 

OUTCLS=(,A) 
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ucs 

Optional for: 
complete 
I/O device 

Not applicable for: 
nucleus 

The UCS macro instruction specifies the IBM standard character-set images for a 1403 printer 
with the universal character set (UCS) feature or for a 321 1 printer. If this macro instruction 
is omitted, it is expected that the IBM or user character-set images will be included by a process 
other than system generation. For information on including your own character-set images, 
refer to OS/VS Data Management for System Programmers. 

For an I/O device generation this macro instruction can be specified to add UCS support for 
the printer if support was not supplied in the last complete system generation. This macro 
instruction does not have to be respecified if it has already been specified in a previous 
generation. 



UCS [DEFAULT=fALL )] 

\ (image [ Jmage ]...)/ 

IMAGE=/ ALL 1403 
1ALL3211 
(ALL 
v (image [ /image ]...), 



Parameter Sub parameter 

DEFAULT= 



ALL 



image 



IMAGE= 



ALL 1403 
ALL3211 
ALL 



Explanation 

specifies the UCS images to be used as defaults when 
a job does not specify an image through its job con- 
trol language statements. 

specifies that all the images specified in the IMAGE 
parameter are to be considered defaults. 

specifies the images in the IMAGE parameter that will 
be defaults. 

It is recommended that all UCS images that can pro- 
duce valid results as defaults be specified. 

specifies the IBM standard character-set images to be 
included as one or more of the following values. 
These values may be listed in any order. 

specifies that all the 1403 UCS images are to be 
included. 

specifies that all the 321 1 UCS images are to be 
included. 

specifies that both the 1403 and 321 1 UCS images 
are to be included. 
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Parameter Subparameter Explanation 

IMAGE= image specifies particular UCS images to be included; the 

(Continued) images are one or more of the values listed in Figure 

12. These values may be listed in any order. 



Value 


IBM Standard Character-Set Image 


1403 Printer 


AN 

HN 

PCAN 

PCHN 

PN 

QNC 

QN 

RN 

SN 

TN 

XN 

YN 


Arrangement A, standard EBCDIC character set, 48 graphics. 

Arrangement H, FORTRAN/COBOL EBCDIC character set, 48 graphics. 

Arrangement A, preferred character set, 48 graphics. 

Arrangement H, preferred character set, 48 graphics. 

PL/I character set, 60 graphics. 

PL/I, commercially preferred character set, 60 graphics. 

PL/I, scientifically preferred character set, 60 graphics. 

FORTRAN/COBOL commercial, 52 graphics. 

Text printing, commercial, 84 graphics. 

Text printing, scientific, 120 graphics. 

High speed alphameric, 1403 Model 2, 40 graphics. 

High speed alphameric, 1403 Model N1, 42 graphics. 


3211 Printer 


A11 
G11 
H11 
P11 
T11 


Standard commercial character set, 48 graphics. 
ASCII character set, 63 graphics. 
Scientific character set, 48 graphics. 
PL/I character set, 60 graphics. 
Text printing, 120 graphics. 



Figure 12. Standard character-set images. 



Example: This macro specifies that the standard character set images AN, HN, PN, and QNC 
are to be included in the system. The images identified by the PN and AN identifications are to 
be the default values. 

UCS UCS IMAGE=(AN,HN,PN,QNC) , DEFAULT= (PN,AN) 
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UNITNAME 

Required for: 
complete 
I/O device 

Not applicable for: 
nucleus 

The UNITNAME macro instruction is used to name a group of I/O devices. A UNITNAME 
macro instruction is required for each named group of I/O devices in the new VS2 system, 
except for unique device types. All UNITNAME macro instructions having the same value 
in the NAME parameter must appear consecutively in the input stream. 

This macro instruction must be used to assign certain names to groups of I/O devices for the 
IBM-supplied cataloged procedures in SYS1.PROCLIB and the installation verification proce- 
dure (IVP) in SYS1.SAMPLIB. The names required are: 

SYSSQ for magnetic tape and/or direct-access devices 
SYSDA for direct-access devices only. 

A maximum of 100 uniquely named groups can be specified for a system. A maximum of 255 
addresses can be in one group. If more addresses must be listed for a particular name, another 
UNITNAME macro instruction is coded using the same name. A maximum of 255 characters 
can be used in the operand of any UNITNAME macro instruction. The maximum number of 
addresses that may be specified is 1028 minus the number of names. The addresses used must 
also be specified in the IODEVICE macro instruction. For a list of I/O devices, see Appendix A. 



UNITNAME 



NAME=A7a/77e 

U N I T= (address [.address] 



Parameter 

NAME= 



Subparameter 

name 



UNIT= 



address 
(address, n) 



Explanation 

specifies the name to be given to a group of I/O 
devices. The name consists of from 1 to 8 characters. 
These characters can be alphameric, national (#, @, 
or $), or the two special characters slash (/) and 
hyphen (-). 

specifies the addresses of a group of I/O devices that 
will be recognized by the name assigned. 

specifies the unit address of an I/O device to be 
included by the name assigned. 

specifies the lowest unit address of a group of 
sequential addresses being specified. The n is the 
number of sequential addresses being assigned. 

The two forms of the UNIT parameter may be 
mixed. If more than one value is expressed, the 
values must be enclosed in parentheses. 
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Parameter Subparameter Explanation 

UNIT= (address, n) If the form (address, n) is used as the only subparam- 

(Continued) (Continued) eter of the macro instruction, double parentheses 

must be used. For example, UNIT=((180,4)) would 
create a group of four devices that have the addresses 
180, 181, 182, and 183. 

The only combination of unlike device types per- 
mitted in a group is magnetic tape and direct-access 
devices. 

Example: This macro specifies that TAPE is the symbolic name associated with devices at 
addresses 1 80, 1 8 1 , 280, 28 1 , and 282. 

UNITNAM1 UNITNAME NAME=TAPE , X 

UNIT= (180,181,280,281,282) 

Example: This macro specifies that DISK is the symbolic name associated with eight consecu- 
tive addresses, beginning at address 130. 

UNITNAM2 UNITNAME NAME=DISK,UNIT= ( (130 , 8) ) 

Example: This example illustrates the use of the UNITNAME macro instruction to assign a 
specific unit name to an unsupported I/O device. The unsupported device is located at address 
167 (specified as UNIT=DUMMY,ADDRESS=167 in an IODEVICE macro instruction). 

UNITNAM3 UNITNAME NAME=167 ,UNIT=167 
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SELECTING THE NEW SYSTEM DATA SETS 

This chapter is divided into two sections. The first section tells how to allocate space to the 
system data sets and catalog them in the system catalog by using either the DATASET macro 
or the IEHPROGM utility program. 

Figure 1 5 presents a summary of the required and optional system data sets. This figure may 
be helpful to refer to when you are specifying the new system data sets. This section also 
contains examples of coding the parameters for the DATASET macro and the control state- 
ments for executing IEHPROGM. 

The information in this section about specifying DD statements and catalog statements applies 
only if you are using the IEHPROGM utility program for allocating space and cataloging. If 
you are using the DATASET macro, you only specify values for the SPACE and VOL param- 
eters and the default values for the remaining parameters are supplied for you. 

The second section contains detailed information about the required and optional system data 
sets for the new VS2 system. In this section, the system data sets are arranged in alphabetical 
order by the fully qualified data set name. The following information is supplied for each of the 
system data sets: 

• Whether the data set is required or optional 

• Whether the data set is sequential, partitioned, or direct 

• What the data set contains 

• What you must know when you are using the IEHPROGM utility program for cataloging 
and allocating space for the system data sets 

Allocating Space to the New System Data Sets and Cataloging Them 
in the System Catalog 

Before the components of the distribution libraries can be placed in the system data sets, 
space must be allocated to them, a system catalog must be built, and the data sets must be 
cataloged in the system catalog. 

SYS1.SVCLIB must be allocated space entirely on the system residence volume. SYS1.SVCLIB 
may not occupy more than 1023 tracks on the system residence volume. The size of 
SYS1.LOGREC is determined during system generation and space is allocated during system 
generation. The maximum space that can be allocated to each of the remaining system data 
sets is one volume, except for SYS1.SYSJOBQE which may not occupy more than 1215 
tracks on a 2314/2319 or more than 745 tracks on a 3330. Alternate track assignment is 
accepted for the system data sets. To achieve maximum efficiency in the new system, alternate 
tracks should not be used for SYS1.LPALIB, SYS1 .LINKLIB, SYS1 .SVCLIB, and 
SYS1.SYSJOBQE. 

Space for the new system data sets can be allocated and the system data sets can be cataloged 
either during system generation, by specifying the DATASET macro in the Stage I input deck, 
or before Stage n, by executing the IEHPROGM utility program. 
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Allocating Space and Cataloging Using the DATASET Macro 

The DATASET macro instruction allocates space to the system data sets and catalogs them in 
the system catalog during the Stage II part of system generation. The parameters in the 
DATASET macro specify the system data set for which space is to be allocated, the volume 
on which it will reside, and the amount of space required on the specified volume. All of the 
system data sets are cataloged for you except SYSCTLG. 

If you use the DATASET macro, one DATASET macro must be specified for each system 
data set that is to make up the new system to be generated. Refer to the description of the 
DATASET macro in "Specifying the New System Control Program." 

Figure 13 illustrates the parameter specifications for the DATASET macro instruction. The 
default values for the system residence volume, specified in the GENERATE macro, are 
RESVOL= (SYSRES, 3330). 



SYSCTLG 


DATASET 


BRODCAST 


DATASET 




VOL : 


CMDLIB 


DATASET 




VOL : 


DSSVM 


DATASET 


HELP 


DATASET 




VOL : 


IMAGELIB 


DATASET 


SAMPLIB 


DATASET 




VOL= 


LINKLIB 


DATASET 


LPALIB 


DATASET 


MACLIB 


DATASET 




VOL= 


NUCLEUS 


DATASET 


PARMLIB 


DATASET 


DCMLIB 


DATASET 




VOL: 


PROCLIB 


DATASET 


SVCLIB 


DATASET 


SYSJOBQE 


DATASET 




VOL: 


TELCMLIB 


DATASET 




VOL: 


UADS 


DATASET 




VOL: 



SYSCTLG , SPACE= (CYL , 
BRODCAST , SPACE= (CYL 

=(SYSLIB,3330) 
CMDLIB , SPACE= (TRK , ( 

=(SYSLIB,3330) 
DSSVM ,SPACE= (2048, ( 
HELP, SPACE= (CYL, (10 

=(SYSLIB,3330) 



(15,5)) 
,(10)) , 

20,1,1)), 

600)) 
,5,10)) , 

,(20, ,8)) 
(100,20,2)) , 



(20,10,5)) 
30,3,150)) 
30,10,5)), 

(2,, 2)) 
(50, ,5)) 
50, ,8)), 



FKUUli±B , SFAU13= ^(JlL , 
SVCLIB,SPACE=(CYL, C 
SYSJOBQE , SPACE= (CYL 

=(111111,2305-2) 
TELCMLIB , SPACE= (CYL , 

=(SYSLIB,3330) 
UADS,SPACE=(TRK, (20 , 

=(SYSLIB,3330) 



(20,5,10)) 

10,2,15)) 

,(100)), 



X 
X 

X 

X 

X 

X 

X 



, (20,2,100)) , X 
,2,5)), X 



Figure 13. Allocating space for the new system data sets and cataloging them in the system 
catalog using the DATASET macro 



Allocating Space and Cataloging Using IEHPROGM 

Instead of using the DATASET macro, the IEHPROGM utility program can be used to allo- 
cate space to the system data sets and to catalog them in the system catalog. 
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If you use IEHPROGM instead of using DATASET macros, space must be allocated and the 
system data sets must be cataloged before you begin Stage n. 

The following text describes the use of IEHPROGM for allocating space for the new system 
data sets and cataloging them Detailed descriptions of the control cards and functions of 
IEHPROGM are in OS/ VS Utilities. 

The input deck for IEHPROGM must contain: 

• A JOB statement with any parameters required by your installation. 

An EXEC statement with the PGM=IEHPROGM parameter. 

A DD statement for the message output data set (SYSPRINT). 

. A DD statement for each of the new system data sets (except for the SYS1 . LOGREC 
data set). These DD statements have the following format: 

//ddname DD DSNAME=dsname , X 

// VOLUME= (, RETAIN, SER=serial) , X 

// UNIT=unit,LABEL=EXPDT=99350, X 

// SPACE= (allocation) , X 

// DISP= (, KEEP ) ,DCB=( see Figure 15) 

A DD * statement (SYSIN). 

. A CATLG statement for each new system data set to be cataloged. Each CATLG 
statement must have the following format: 



CATLG DSNAME=dsname,CVOL=unit=serial , 
VOL=unit= serial 



X 



The DD and CATLG statements for IEHPROGM are discussed in the following sections. For 
more information on the coding of parameters, refer to OS/VS JCL Reference. 

Specifying the DD Statements for the IEHPROGM Input Deck 

The DD statements in the input deck for IEHPROGM have the following parameters and sub- 
parameters: 

Parameter Subparameter Explanation 

DSNAME= dsname specifies the system data set to be initialized. 

VOLUME= (, RETAIN, specifies the serial number of the direct-access 

SER= serial) volume on which the system data set is to reside. 

UNIT= unit specifies the name of the direct-access device on 

which the volume containing the data set is to reside. 

LABEL= EXPDT=99350 specifies the expiration date for the system data set 

to prevent accidental deletion. 

SPACE= space specifies the amount of storage to be allocated to 

the system data set. Information on space allocation 
is found in OS/VS2 Storage Estimates. 
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Parameter 


Subparameter 


DISP= 


(,KEEP) 


DCB= 


(DCB information) 



Explanation 

specifies the disposition of the system data set. 
This parameter must be coded as shown. 

specifies any DCB information that may be required 
by the system data sets. 



Specifying the CATLG Statements for the IEHPROGM Input Deck 

The parameters that are required for the catalog statements are described in the following text. 
Refer to "Selecting the New System Data Sets" for the system data sets that need to be 
cataloged. 



Explanation 

specifies the name of the system data set to be 
cataloged. 

specifies the unit name and serial number of the new 
system residence volume. (The values must be the 
same as specified in the DD statement for 
SYS1. NUCLEUS.) 

specifies the unit name and serial number of the 
volume on which the system data set resides. These 
values must be the same as specified in the corre- 
sponding DD statement for the system data set. 

Figure 14 illustrates the control statements for executing IEHPROGM. Space requirements 
for the system data sets are determined by several factors, especially the type of device used 
and the characteristics of the system control program to be generated. Exact storage require- 
ments on various types of direct-access devices are in OS/VS2 Storage Estimates. 



Parameter 
DSNAME= 

CVOL= 



VOL= 



Subparameter 

dsname 

unit= serial 



unit= serial 



//NEWSYS 

// 

//SYSPRINT 

//SYSCTLG 

// 

// 

//CMDLIB 

// 
// 
// 
//HELP 

// 
// 
// 



JOB 

EXEC PGM=IEHPROGM 
DD SYSOUT=A 

DD DSNAME=SYSCTLG,DISP=(,KEEP) , 
VOLUME=(, RETAIN, SER=SYSRES) ,UNIT=3330, 
LABEL=EXPDT=99350,SPACE=(CYL, (15,5)) 
DD DSNAME=SYS1. CMDLIB, DISP= ( ,KEEP) , 
VOLUME=(, RETAIN, SER=SYSLIB) ,UNIT=3330, 
LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=13030) , 
SPACE=(TRK, (20,1,1) ) 

DD DSNAME=SYS1. HELP, DISP=(, KEEP) , 
VOLUME=(, RETAIN, SER=SYSLIB) ,UNIT=3330, 
DCB=(RECFM=FB,LRECL=80,BLKSIZE=12960) , 
SPACE=(CYL, (10,5,10) ) 



X 
X 

X 
X 
X 

X 
X 
X 



Figure 14 (Part 1 of 3). Allocating space for the new system data sets and cataloging them in the system catalog 
using IEHPROGM 
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//SAMPLIB 

// 

I// 
// 
//LINKLIB 

// 
// 
// 
//LPALIB 

// 
// 

// 
//MACLIB 

// 

// 

// 
//PROCLIB 

// 
// 
// 
//SVCLIB 

// 
// 
// 
//TELCMLIB 

// 
// 
// 
//UADS 

// 
// 
// 
//IMAGELIB 

// 
// 

// 
//NUCLEUS 

// 
// 
//PARMLIB 

// 
// 
// 
//BRODCAST 

// 
// 



DD DSNAME=SYS1. SAMPLIB ,DISP= ( ,KEEP) , 

VOLUME=(, RETAIN, SER=SYSLIB) ,UNIT=3330, 

LABEL=EXPDT=9 9 3 5 , DCB= ( RECFM=F , LRECL= 8 , BLKS I ZE= 

SPACE=(TRK, (100,20,2) ) 

DD DSNAME=SYS1. LINKLIB, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSRES) ,UNIT=3330, 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=13030) , 

SPACE=(CYL, (20,10,5) ) 

DD DSNAME=SYS1. LPALIB, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSRES) ,UNIT=3330, 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=13030) , 

SPACE=(CYL, (30,3,150) ) 

DD DSNAME=SYS1. MACLIB, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSLIB) ,UNIT=3330, 

LABEL=EXPDT=99350,DCB=(RECFM=FB,BLKSIZE=12960, 

LRECL=80) ,SPACE=(CYL, (30,10,5) ) 

DD DSNAME=SYS1. PROCLIB, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSRES) ,UNIT=3330, 

LABEL=EXPDT=99350,DCB= (RECFM=F ,BLKSIZE=80) , 

SPACE=(CYL, (20,5,10) ) 

DD DSNAME=SYS1. SVCLIB, DISP=(, KEEP) , 

VOLUME= (, RETAIN, SER=SYSRES) ,UNIT=3330 , 

LABEL=EXPDT= 99350, DCB= (DSORG=POU , RECFM=U , 

BLKSIZE=4096) ,SPACE=(CYL, (10,2,15)) 

DD DSNAME=SYS1. TELCMLIB, DISP=(, KEEP) , 

VOLUME= (, RETAIN, SER=SYSLIB) ,UNIT=3330 , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=13030) , 

SPACE=(CYL, (20,2,100) ) 

DD DSNAME=SYS1. UADS, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSLIB) ,UNIT=3330, 

DCB=(RECFM=FB,DSORG=PO,BLKSIZE=800,LRECL=80) , 

SPACE=(TRK, (20,2,5) ) 

DD DSNAME=SYS1. IMAGELIB, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSRES) ,UNIT=3330, 

LABEL=EXPDT=99350,SPACE=(TRK, (20,, 8)) , 

DCB=(RECFM=U,BLKSIZE=13030) 

DD DSNAME=SYS1. NUCLEUS, DISP=(, KEEP) , 

VOLUME= ( , RETAIN, SER=SYSRES) ,UNIT=3330 , 

LABEL=EXPDT=99350,SPACE=(CYL, (2, ,2) , ,CONTIG) 

DD DSNAME=SYS1.PARMLIB,DISP=(,KEEP) , 

VOLUME=(, RETAIN, SER=SYSRES) ,UNIT=3330, 

LABEL=EXPDT=99350,DCB-(RECFM=F,BLKSIZE=80) , 

SPACE=(TRK, (50, ,5) , ,CONTIG) 

DD DSNAME=SYS1. BRODCAST, DISP=(, KEEP) , 

VOLUME=(, RETAIN, SER=SYSLIB) ,UNIT=3330, 

SPACE=(CYL, (10) , ,CONTIG) 



X 

X 

= 80) ,X 

X 
X 
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X 
X 
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X 
X 
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Figure 14 (Part 2 of 3). Allocating space for the new system data sets and cataloging them in the system catalog 
using IEHPROGM 
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//SYSJOBQE 
// 

// 
//DCMLIB 

// 
// 
//DSSVM 

// 

// 

//SYSIN DD 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 
CATLG 

/* 



DD DSNAME=SYS1 

VOLUME=(, RETAIN 

SPACE=(CYL, (100 

DD DSNAME=SYS1 

VOLUME= ( , RETAIN 

SPACE=(TRK, (50, 

DD DSNAME=SYS1 

VOLUME= ( , RETAIN 

SPACE=(2048, (60 
* 



. SYSJOBQE, DISP=(, KEEP) , 

,SER=111111) ,UNIT=2305-2, 

) ,,CONTIG) 

. DCMLIB, DISP=(, KEEP) , 

,SER=SYSLIB) ,UNIT=3330, 

,8)) 

. DSSVM, DISP=(, KEEP) , 

,SER=SYSRES) ,UNIT=3330, 

0) , ,CONTIG) 



X 
X 

X 
X 

X 
X 



CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 
CVOL= 



= 3330= 
=3330= 
=3330= 
= 3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 
=3330= 



=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 
=SYSRES 



,VOL=3330=SYSLIB,DSNAME=SYSl.CMDLIB 

,VOL=3330=SYSLIB,DSNAME=SYS1.HELP 

,VOL=3330=SYSLIB,DSNAME=SYS1.SAMPLIB 

,VOL=3330=SYSRES,DSNAME=SYS1.LINKLIB 

,VOL=3330=SYSRES,DSNAME=SYS1.LPALIB 

,VOL=3330=SYSLIB,DSNAME=SYS1.MACLIB 

,VOL=3330=SYSRES,DSNAME=SYS1.PROCLIB 

,VOL=3330=SYSRES,DSNAME=SYS1.SVCLIB 

,VOL=3330=SYSLIB,DSNAME=SYS1.TELCMLIB 

,VOL=3330=SYSLIB,DSNAME=SYS1.UADS 

,VOL=3330=SYSRES,DSNAME=SYS1.IMAGELIB 

,VOL=3330=SYSRES,DSNAME=SYS1. NUCLEUS 

,VOL=3330=SYSRES,DSNAME=SYS1.PARMLIB 

,VOL=3330=SYSLIB,DSNAME=SYS1.BRODCAST 

,VOL=2305-2=111111,DSNAME=SYS1. SYSJOBQE 

,VOL=3330=SYSLIB,DSNAME=SYS1. DCMLIB 

,VOL=3330=SYSRES,DSNAME=SYS1. DSSVM 



Figure 14 (Part 3 of 3). Allocating space for the new system data sets and cataloging them in the system catalog 
using IEHPROGM 

System Data Set Summary 

Figure 15 lists the required and optional system data sets. This figure may be helpful to refer to 
when you are allocating space to the new system data sets and cataloging them. The values given 
for the DCB subparameters for the data sets must be specified if you are using the IEHPROGM 
utility program. If you use the DATASET macro, these values are the default values that are 
used. These values must not be specified if you are using the DATASET macro. 
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System Data 
Sets 


Type 


System 
Residence 


Secondary 

Volume 

Allocation 


DCB 
Subparameters 


Cataloged 


Required System Data Sets 


SYSCTLG 


sequential 


required 


yes 


none 


no 


SYS1.DSSVM 


sequential 


optional 


no 


none 6 


yes 


SYS1.LINKLIB 1 


PDS 


optional 


yes 


RECFM=U, BLKSIZE=7294 2 


yes 


SYS1.LPALIB 


PDS 


optional 


yes 


RECFM=U, BLKSIZE=7294 2 


yes 


SYS1.L0GREC 4 


sequential 


required 


no 


none 


no 


SYS1.MACLIB 


PDS 


optional 


yes 


RECFM=FB,LRECL=80, 
BLKSIZE=7280 3 


yes 


SYS1. NUCLEUS 


PDS 


required 


no 


none 


yes 


SYS1.PARMLIB 


PDS 


optional 


no 


RECFM=F,BLKSIZE=80 


yes 


SYS1.PR0CLIB 


PDS 


optional 


yes 


RECFM=FB,LRECL=80, 
BLKSIZE=72803 


yes 


SYS1.SAMPLIB 


PDS 


optional 


yes 


RECFM=F, LRECL=80,BLKSIZE=80 


optional 


SYS1.SVCLIB 1 


PDS 


required 


yes 


DSORG=POU,RECFM=U, 
BLKSIZE=4096 


yes 


SYS1.SYSJ0BQE 


sequential 


optional 


no 


none 


yes 


Optional System Data Sets 


SYS1.BR0DCAST 5 


direct 


optional 


no 


none 


yes 


SYS1.CMDLIB 5 


PDS 


optional 


yes 


RECFM-U, BLKSIZE=7294 2 


yes 


SYS1.DCMLIB 


PDS 


optional 


no 


none 


yes 


SYS1.DUMP 


sequential 


optional 


no 


none 


optional 


SYS1.HELP 5 


PDS 


optional 


yes 


RECFM=FB, LRECL=80, 
BLKSIZE=7280 3 


yes 


SYS1.IMAGELIB 


PDS 


optional 


no 


RECFM=U, BLKSIZE=1024 


yes 


SYS1.MANX 


sequential 


optional 


no 


none 


optional 


SYS1.MANY 


sequential 


optional 


no 


none 


optional 


SYS1.SYSVLOGX 


sequential 


optional 


no 


RECFM=VB,BLKSIZE=7294 2 


yes 


SYS1.SYSVLOGY 


sequential 


optional 


no 


RECFM=VB,BLKSIZE=7294 2 


yes 


SYS1.TELCMLIB 


PDS 


optional 


yes 


RECFM=U, BLKSIZE=7294 2 


yes 


SYS1.UADS 5 


PDS 


optional 


yes 


DSORG=P0, LRECL=80, 
RECFM=FB, BLKSIZE=800 


yes 


1 
Space should be allocated in cylinders. 

2 Use BLKSIZE=7294 if the system data set resides on a 2314 or 2319. Use BLKSIZE=14136 for a 2305-1 , BLKSIZE=14660 for 
a 2305-2, and BLKSIZE=13030 for a 3330. 

3 The value of BLKSIZE must be a multiple of 80 that is less than or equal to 7280 for a 2314 or 2319, 14080 for a 2305-1, 14640 
for a 2305-2, or 12960 for a 3330. 

4 

Space must not be allocated by the user. 
5 

Required for a system with TSO. 

If this data set is specified using IEHPROGM, the following must be specified in the SPACE parameter: 
SPACE=(2048, (600>„CONTIG) 

Note: The blocksize found in the DSCB for system data sets whose record format is undefined (RECFM=U) will be the maximum 
blocksize for the device being used. This is not necessarily the size of the current record. 



Figure 15. Summary of the required and optional system data sets 
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SYSCTLG 

Required 
Sequential 



Contents 

Creation 

Requirements 

for 

Specification 



This system data set contains pointers to all the cataloged data sets in the new VS2 system. 

The initial entries are created by the system generation process. 

Location: 

This data set must be on the system residence volume. 

DD Statement: 

The standard format is used. 

The serial number of the new system residence volume must be specified for this data set. 

Secondary space allocation can be specified. 

CATLG Statement: 

This statement must not be coded for this data set. 

For further information on this data set, refer to OS/VS2 Manning and Use Guide. 
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SYS1.BR0DCAST 

Required for TSO 

systems 
Direct 



Contents 



Requirements 

for 

specification 



Notes 



This system data set stores two types of TSO messages: 

, Notices — messages available for all users of the system 
• Mail — messages available for specific users of the system 

To facilitate the access of each type of message, the system data set also contains a Notice 
Directory and a Mail Directory. 

For additional information about the data set, refer to OS/VS2 TSO Command Language 
Reference. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement- 
Space must be allocated. 
Secondary space allocation cannot be specified. 
DCB parameters cannot be specified. 

CATLG Statement: 

This data set should be cataloged in the system catalog (SYSCTLG). 

Initialization: 

After system generation, the first use of the data set causes it to be formatted and initialized. 
The data set will not be reformatted until another system generation. 

This data set does not contain an expiration date. 
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SYS1.CMDLIB 

Required for TSO 

systems 
Partitioned 



Contents 

Requirements 

for 

specification 



This system data set is a load library for command processor programs. 

Location: 

This system data set must be on a direct-access volume, which can be the system residence 
volume. 



DD Statement: 

Secondary space allocations can be specified. 

One of the following DCB subparameters must be specified: 

RECFM=U, BLKSIZE= /14136) for a 2305-1 
1 14660 ( for a 2305-2 
) 7294 ( for a 23 14 
1 13030 J for a 3330 

If you use the DATASET macro, these are the values that are used for the specified devices. 

CATLG Statement: 

This data set should be cataloged in the system catalog (SYSCTLG). 
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SYS1.DCMLIB 

Required if programmed- 
function-key (PFK) 
command is specified 
in the SCHEDULR or 
SECONSLE macro 
instructions. 

Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains the definitions of programmed-function-keys assigned for 
operator command entry. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

Secondary space cannot be allocated. 

CATLG Statement: 

This data set should be cataloged in the system catalog (SYSCTLG). 
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SYS1.DSSVM 

Required 
Sequential 



Contents 



Requirements 

for 

specification 



This system data set contains DSS language processing routines, a nucleus map area, a work 
space area, a nucleus swap area, and DSS change pages. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

If space is allocated with the DATASET macro, the following values must be specified in the 
SPACE parameter: 

SPACE=(2048,(600)) 

If IEHPROGM is used instead, the following values must be specified in the DD statement that 
identifies SYS l.DSSVM: 

SPACE=(2048, (600), , CONTIG) 

Secondary space cannot be allocated. 

CATLG Statement : 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.DUMP 

Optional 
Sequential 



Contents 



Requirements 

for 

specification 



Notes 



This system data set contains system dumps that are used to record areas of virtual storage in 
case of system task failures. 

For further information on this data set, refer to OS '/VS Debugging Guide. For information on 
the AMDPRDMP service aid that is used to process the dumps, refer to OS/VS Service Aids. 

Location: 

This data set can be on either a direct-access volume or a magnetic tape volume. It can be on 
the system residence volume. 

The volume that contains this data set can be on a: 



2305-1 


fixed-head storage facility 


2305-2 


fixed-head storage facility 


2314 


direct-access storage facility 


2319 


direct-access storage facility 


2400 


series magnetic tape unit 


3400 


series magnetic tape unit 


3330 


disk storage drive 


) Statement: 



This statement is used only if this system data set is on a direct-access volume and you choose 
to allocate space. In this case, you must also write an end-of-file (EOF) record as the first 
record in the data set. If you do not allocate space for this data set and it is cataloged, the 
nucleus initialization program (NIP) allocates it for you and writes the EOF record when the 
system is loaded. 

Secondary space cannot be allocated. 

CATLG Statement: 

Code this statement only if this data set is going to be on a direct-access volume. 

If this data set is going to be on a magnetic tape volume, it must be specified at IPL. It cannot 
be cataloged during the preparation for system generation. 
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SYS1.HELP 

Required if the TSO 
HELP command is to 
be used in a system 
with TSO 

Partitioned 



Contents 



Requirements 

for 

specification 



Notes 



Each member of this system data set contains TSO HELP information regarding the syntax, 
operands, and functions for each TSO command. 

Location: 

This data set must be on a direct-access volume. It can be on the system residence volume. 

DD Statement: 

Secondary space allocations can be specified. 

The following DCB subparameters must be specified: 

RECFM=FB, LRECL=80, 

BLKSIZE= a multiple of 80, which is less than or equal to: 

80 if unblocked 

14080 for a 2305-1 

14640 for a 2305-2 

7280 for a 23 14 

12960 for a 3330 

If you use the DATASET macro, these are the values that are used for the specified devices. 

CATLG Statement: 

This data set should be cataloged in the system catalog (SYSCTLG). 

For further information on this data set, see OS/VS2 TSO Command Language Reference. 
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SYS1.IMAGELIB 

Required if a 1403 
printer with the 
universal character - 
set features 
(UNVCHSET) or a 
3211 printer is in 
the system. 

Partitioned 



Contents 



Requirements 

for 

specification 



This data set contains the universal character -set (UCS) and forms control buffer (FCB) 
image modules. 

For information about this system data set, refer to OS/ VS Data Management for System 
Programmers. 

Location: 

This data set must be permanently mounted on a direct-access volume, which can be the system 
residence volume. 



DD Statement- 
Space must be allocated. 
No secondary space allocation is allowed. 
The following DCB subparameters must be specified: 

RECFM=U, BLKSIZE=1024 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.LINKLIB 

Required 
Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains programs and routines that are referred to by the XCTL, ATTACH, 
LINK, and LOAD macro instructions and nonresident VS2 system routines. 

This system data set also contains an assembler-language processor, a linkage editor, the utility 
programs, and service aids. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

Space should be allocated in cylinders. For maximum efficiency, alternate tracks should not be 
used. 

Secondary space allocations can be specified. 

The following DCB subparameters must be specified: 

RECFM=U, BLKSIZE= /14136 \ for a 2305-1 
1 14660 / for a 2305-2 
J 7294 [ for a 23 14 
1 130307 for a 3330 

If you use the DATASET macro, these are the values that are used for the specified devices. 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.L0GREC 

Required 
Sequential 



Contents 



Requirements 

for 

specification 



Notes 



This system data set is used to contain statistical data about machine failures (CPU failures, 
I/O device errors, and channel errors). 

Location: 

The system generation process allocates space for this data set on the system residence volume. 

DD Statement: 

This statement must not be coded for this data set. 

CATLG Statement: 

This statement must not be coded for this data set. 

The size of this data set can be increased or decreased after system generation by use of the 
IFCDIPOO program. Information on this program is in OS/VS SYS1. LOGREC Error 
Recording. For information on space allocation for reinitializing this data set, refer to OS/VS2 
Storage Estimates. 
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SYS1.LPALIB 

Required 
Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains all of the modules that are loaded into the link pack area (LP A). 
This includes system routines, SVC routines, data management access methods, nonresident 
machine-check handler modules, and some TSO modules. 

Information about this data set can be found in OS/VS2 Planning and Use Guide. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

The standard format is used. 

Secondary space allocation can be specified. 

The following DCB subparameters must be specified: 

RECFM=U, BLKSIZE= (14136 ) for a 2305-1 
) 14660 ( for a 2305-2 
) 72941 for a 23 14 
M 3030 ^ for a 3330 

If you use the DATASET macro, these are the blocksizes that are used. 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.MACLIB 

Required 
Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains the macro definitions for supervisor and data management macro 
instructions. 

Location: 

This data set must be on a direct-access volume, which may be the system residence volume. 

DD Statement: 

Secondary space allocations can be specified. 

The following DCB subparameters must be specified: 

RECFM=FB,LRECL=80, 

BLKSIZE= a multiple of 80 which is less than or equal to: 

80 if unblocked 

14080 for a 2305-1 

14640 for a 2305-2 

7280 for a 2314 

12960 for a 3330 

If you use the DATASET macro, these are the values that are used for the specified devices. 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.MANX, SYS1.MANY 

Required if the recording 

function of the system 

management facility 

(SMF) feature is to be 

used. 
Sequential 

Contents Both of these system data sets contain the data collected by the SMF routines. (For informa- 

tion on SMF, refer to OS/VS System Management Facilities (SMF).) 

Requirements Location: 

I . . Both data sets should be defined on the same direct-access device type. They must reside on a 

specification permanently mounted volume, which can be the system residence volume. 

DD Statement: 

Secondary space allocations, if they are coded, are ignored. 

Space allocation for both data sets should be the same. 

CATLG Statement: 

These data sets should be cataloged in the system catalog (SYSCTLG). 
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SYS1. NUCLEUS 

Required 
Partitioned 



Contents 



This system data set contains the resident portion (nucleus) of the control program. The 
member name is IEANUC01 . 



Requirements 

for 

specification 



Location: 

This data set must be on the system residence volume. 

DD Statement: 

The serial number of the new system residence volume must be specified for this data set. 

Secondary space cannot be allocated. 

CATLG Statement: 

You must catalog this data set in the system catalog (SYSCTLG). 
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SYS1.PARMLIB 

Required 
Partitioned 



I Contents 

I 



Requirements 

for 

specification 



This system data set contains the IEASYSOO and SMFDEFLT system parameter lists that are used 
by the nucleus initialization program (NIP), the PRESRES list that is used by the master 
scheduler, the system parameters that are defined during system generation, the LNKLSTOO list 
that is used to concatenate data sets to SYS1 .LINKLIB and the IEAFIXnn lists that are used 
to indicate the routines from SYS 1 .LINKLIB and SYS1 .LPALIB that are to become part of 
the resident portion of the link pack area. 

For additional information about this system data set, refer to OS/VS2 Planning and Use Guide. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

Space must be allocated for this data set. 

Secondary space cannot be allocated. 

The following DCB subparameters must be specified: 



RECFM=F,BLKSIZE=80 



CATLG Statement: 



This data set must be cataloged in the system catalog (SYSCTLG) if it does not reside on the 
system residence volume. You should, however, always catalog this data set. 
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SYS1.PR0CLIB 

Required 
Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains the cataloged procedures used to perform certain system 
functions, such as reader, writer, and initiator procedures. The cataloged procedures can be for 
system tasks or processing program tasks invoked by the operator or the programmer. 

For information on this system data set, refer to OS/VS2 Planning and Use Guide. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

Space must be allocated for this data set. 

Secondary space allocations can be specified. 

It is recommended that the following DCB subparameters be used: 

RECFM=FB, LRECL=80, 

BLKSIZE= a multiple of 80, which is less than, or equal to: 

80 if unblocked 

14080 for a 2305-1 

14640 for a 2305-2 

7280 for a 23 14 

12960 for a 3330 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG) if it does not reside on the 
system residence volume. 

You should always catalog this data set. 
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SYS1.SAMPLIB 

Required 
Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains the installation verification procedure (see "Testing the System 
Control Program"), the independent utilities, and the IPL text. It also contains SMF sample exit 
routines. (For information about punching the independent utilities, IPL text, and SMF exit 
routines, see "Preparing for System Generation.") 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

Secondary space allocations can be specified. 

The following DCB subparameters must be specified: 

RECFM=F,LRECL=80,BLKSIZE=80 



If you use the DATASET macro, these are the values that are used for the specified devices. 

CATLG Statement: 

This data set need not be cataloged. 
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SYS1.SVCLIB 

Required 
Partitioned 



Contents 



Requirements 

for 

specification 



This system data set contains system routines that are used by the nucleus initialization 
program (NIP) when the system is loaded. 

Location: 

This data set must be on the system residence volume. 

DD Statement: 

The serial number of the new system residence volume must be specified for this data set. 

This data set cannot occupy more than 1023 tracks on the system residence volume. 

Secondary space allocations can be specified. 

Space should be allocated in cylinders. For maximum efficiency, alternate tracks should not be 
used. 

The following DCB subparameters must be specified: 
DSORG=POU, RECFM=U, BLKSIZE=4096 

Catalog Statement: 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.SYSJ0BQE 

Required 
Sequential 



Contents 



Requirements 

for 

specification 



Notes 



This system data set contains the input queue and output queue. It is used by the job scheduler 
as a storage and work area for information about the input and output streams. For information 
about this system data set, refer to OS/VS2 Planning and Use Guide. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

For maximum efficiency, alternate tracks should not be used. 

Contiguous space must be allocated for this data set. No more than 1215 tracks can be on a 2314 
or 2319, and no more than 745 on a 3330. A full volume can be allocated on a 2305-1 or 2305-2. 
Secondary space allocations cannot be specified. 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG) if it does not reside on the 
system residence volume. 

You should always catalog this data set. 

If this data set is date-protected, the operator will have to reply to an ENTER message if he 
formats the job queue. 

This data set must be formatted when the new VS2 system is loaded for the first time. (For 
detailed information, see the Operator's Library: OS/VS2 Reference.) 

This data set is not used during system generation. Therefore, it does not have to be cataloged 
and have space allocated for it until just before the IPL procedure. For convenience, it is 
recommended that you catalog it and allocate space for it with the other system data sets. 
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SYS1.SYSVL0GX, SYS1.SYSVL0GY 

Required if a system log 

is to be used in the 

system 
Sequential 



Contents 



Requirements 

for 

specification 



These system data sets contain system log data that consists of: 

Write-to-log (WTL) messages 

Data entered by the operator 

The time it takes for a job and step to-run, and data from the JOB and EXEC statements 
of a job that has ended 

Write-to-operator (WTO) and write-to-operator reply (WTOR) messages 

Accepted replies to WTOR messages 

Operator commands 

Location: 

These data sets must be on direct-access volumes, which can be the system residence volume. 

DD Statement: 

Secondary space allocations cannot be specified. 

One of the following DCB subparameters must be specified: 

RECFM=VB, BLKSIZE= < 14136 \ for a 2305-1 
1 14660 / for a 2305-2 
| 7294 ( for a 2314 
U3030/ for a 3330 



Notes 



CATLG Statement: 

This statement must be specified. 

These data sets are not used during system generation. Therefore, they do not have to be 
cataloged and have space allocated for them until just before the new system is loaded. For 
convenience, it is recommended that you allocate space for these data sets and catalog them 
at the same time you do it for the other system data sets. 
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SYS1.TELCMLIB 

Required if BTAM or 
TCAM will be in the 
system. 

Partitioned 



Contents 

Requirements 

for 

specification 



This system data set contains telecommunications subroutines in load module form. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

Secondary space allocations can be specified. 

The following DCB subparameters must be specified: 

RECFM=U, BLKSIZE= /14136 \ for a 2305-1 
\ 14660 I for a 2305-2 
j 7294 (for a 2314 
U3030 Jfora3330 

If you use the DATASET macro instruction, these are the values that are used for the specified 
devices. 

CATLG Statement: 

This data set must be cataloged in the system catalog (SYSCTLG). 
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SYS1.UADS 

Required for 

systems with TSO 
Partitioned 



Contents 



Requirements 

for 

specification 



Notes 



This system data set contains a list of authorized terminal users, and information about 
each of them. 

Location: 

This data set must be on a direct-access volume, which can be the system residence volume. 

DD Statement: 

The standard format is used. 

Secondary space allocations can be specified. 

The following DCB subparameters must be specified: 

DSORG=PO, LRECL=80, BLKSIZE=800, RECFM=FB 

CATLG Statement: 

This data set should be cataloged. 

This data set does not contain an expiration date. 

For further information about this data set, refer to OS/VS2 TSO Command Language 
Reference. 
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PREPARING FOR SYSTEM GENERATION 



This chapter describes the preparation for a system generation. The following topics are 
discussed: 

• Initializing direct-access volumes 

• Using the starter system as the generating system 

• Using an existing VS2 system as the generating system 

• Adding your own routines to the new VS2 system to be generated 



Initializing Direct-Access Volumes 



Before a VS2 System Control Program can be generated, the volumes that are to contain the 
starter system, the distribution libraries, and the new system must be initialized. 

Volume initialization is the process of writing home addresses, a volume label, and a volume 
table of contents (VTOC) on a direct-access volume. In addition, the initial program load (IPL) 
program must be written on the direct-access volume that is to become the new system 
residence volume. 

Volumes are initialized by either the IBCDASDI or the IEHDASDR utility programs. The 
IBCDASDI utility program is self-loading and its operation is independent of an operating 
system. The IEHDASDR utility program operates under the control of an operating system. 
The IEHDASDR utility program is on the starter system tape in SYS1 .LINKLIB or in your 
existing system in SYS 1. LINKLIB. 

IBCDASDI, which is in the first file of the starter system tape, is used to initialize the volume 
that will contain the starter system. After the starter system has been restored to the 
initialized volume and the IPL procedure performed, the IEHDASDR utility program, under 
the control of the starter system, can be used to initialize the volumes that are to contain the 
distribution libraries and the VS2 System Control Program. 

The IBCDASDI or IEHDASDR utility programs can also be used to include the IPL program 
on the volume that is to be the new system residence volume. The section "System Generation 
Using the Starter System" in this chapter describes the procedure used to obtain the IPL 
program cards for inclusion on the new system residence volume. 

These utility programs and the control statements they require are described in OS/VS Utilities, 
their use in preparing for system generation is discussed in the "System Generation Using the 
Starter System" section of this chapter. 



System Generation Using the Starter System 



You must use the starter system provided by IBM for your first system generation (see 
"Requirements for Generating a New System Control Program"). After your first system 
generation, you can use your existing VS2 system for later system generations (see "System 
Generation Using an Existing VS2 System" in this chapter). 

This section discusses what you must consider before using the starter system and the process- 
ing procedures that must be performed before the starter system and distribution libraries can 
be used for system generation. 
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Starter System Special Considerations 

Special considerations that apply only to the starter system are described here. 

I/O Devices 

All devices to be used should be ready before IPL; any device not ready will automatically be 
taken off line. However, all teleprocessing control units such as the 2701, 2702, or 2703 should 
be disabled before IPL. If a device that was not ready at IPL is required during a job step, the 
operator should enter a VARY ONLINE command for that device. 

The Dual-Density Feature and 9-Track Magnetic-Tape Drives 

For 9-track magnetic-tape drives with or without the dual-density feature, the starter system 
will assume a default value for tape of 800 BPI, regardless of whether the tape volumes mounted 
on the drives have standard labels or no labels. 

If you want to use 1600 BPI for 9-track tape drives with or without the dual-density feature, 
then you must specify the density in the DCB parameter of the DD statements for all the data 
sets that will reside on these drives. This applies if the tape volumes mounted on the drives 
have standard labels or no labels. The density specification for 1600 BPI will not be passed on 
from one step of a job to the next, and 1600 BPI cannot be used for SYSOUT. 

System/370 Model 158 

When using the System/370 Model 158, the 3215 mode must be used. 

Processing the Starter System and Distribution Library Tapes 

Certain procedures need to be followed before the starter system and distribution libraries can 
be used for system generation. These procedures consist of: 

Preparing for volume initialization 

Initializing the volumes that are to contain the starter system and distribution libraries 
Dumping the starter system from tape to a direct-access volume (STARTR) 
Starting the starter system 

Copying the distribution libraries from the tape volume (DLIBT1) to another direct- 
access volume (DLIB0 1 ) 

Punching the independent utilities and IPL text on DLIB01 
Listing the volume table of contents (VTOC) on STARTR and DLIB01 
Initializing the volume that is to contain the new VS2 system 

This section describes a procedure that can be followed to prepare for system generation. In 
this example, the direct-access devices that are used for the volumes that are to contain the 
starter system, distribution libraries, and the new system are 3330s. This procedure can also be 
used with a 2314/2319. If a 2314/2319 is being used, the parameters that specify the device 
must be changed. 

For illustrative purposes, the procedures assume the following set of devices and unit addresses: 

I/O Device Device Function Address 

3210 console console keyboard 01F 

3330 disk storage drive starter system volume - STARTR 150 

3330 disk storage drive distribution library volume - DLIB01 151 

3330 disk storage drive new system volume - SYSRES 152 

2540 reader system input 00C 

2540 punch punched output 00D 

1403 printer printed output 00E 

2400 tape drive tape drive for starter system tape and 182 

distribution library tape (DLIBT1) 
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Prepare to Initialize the Volume That Will Contain the Starter System 

1 . Mount the disk volumes onto which the contents of the starter system tape are to be 
dumped and the contents of the distribution library tape are to be copied. 

2. Mount the starter system tape. The first file of the tape contains the IBCDASDI indepen- 
dent utility program. The second file contains the IBCDMPRS independent utility 
program. 

3. Load the IBCDASDI independent utility program from the starter system tape by setting 
the load selector switches and pressing the console LOAD key. After the program has 
been loaded, the wait state is entered and the hexadecimal value FFFF is displayed in 
the console lights. 

Initialize the Volume That Will Contain the Starter System 

4. Place the following IBCDASDI control statements in the input device: 



INITVOL 



JOB 

MSG 

DADEF 

VLD 

VTOCD 

END 



TODEV=1403 ,TOADDR=00E 

TODEV= 3330 ,TOADDR=150,VOLID= SCRATCH,FLAGTEST=NO 
NEWVOLID=STARTR , OWNERID= DEPT38 
STRTADR=05 , EXTENT=10 



Note: The underlining in this and subsequent examples indicates that the device, unit 
address, or parameter value was arbitrarily chosen. 

If the volume is being initialized for the first time, the parameter FLAGTEST=NO must 
be included in the DADEF statement. 

5. Define the control statement input device by pressing the REQUEST key of the console 
keyboard. The message DEFINE INPUT DEVICE will be printed. Enter the reply 
INPUT=2540, 00C where 2540 is the device type and 00C is the unit address. If this is 
not the device type and/ or unit address of your input device, enter the correct informa- 
tion. 

6. When the volume initialization is complete, the message END OF JOB is printed on the 
message output device, and the system enters the wait state. 

Dump the Contents of the Starter System Tape to a Direct-Access Volume 

7. Load the IBCDMPRS independent utility program from the second file of the starter 
system tape by pressing the console LOAD key again. When the program is loaded, the 
wait state is entered and the hexadecimal value FFFF is displayed in the console lights. 

Place the following IBCDMPRS control statements in the input device to dump the 
contents of the starter system tape to disk: 



DUMPTAPE JOB 

MSG TODEV= 1403 , TOADDR= 00E 

RESTORE FROMDEV= 24 00 , FROMADDR=182 , TODEV= 3330 , 

TOADDR=150 , VOLID=STARTR 
END 



X 
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8. Define the control statement input device by pressing the REQUEST key of the console 
keyboard. The message DEFINE INPUT DEVICE will be printed. Enter the reply 
INPUT =2540 , Q0C where 2540 is the device type and 00C is the unit address. If this is 
not the device type and/or unit address of your input device, enter the correct informa- 
tion. 

9. When the contents of the starter system tape have been dumped to disk, the message 
END OF JOB is printed on the message output device, and the system enters the wait 
state. 

Starting the Starter System 

Making the starter system operative includes initial program loading (IPL), initializing the 
nucleus (NIP), readying the scheduler, and starting a reader, a writer, and an initiator. The 
following procedures can be used to make the starter system operative. Appendix F shows 
the entire process as it would appear on the console. 

10. Set the load selector switches on the control panel to the unit address of the volume that 
contains the starter system. Then press the LOAD key. 

1 1 . Signal EOB to the SPECIFY SYSTEM PARAMETERS message. 

12. Signal EOB to the request for a DUMP data set. 

13. When the starter system is ready to begin working, it sends you the message: READY. 

14. The date and time of day are printed along with the message REPLY WITH SET 
PARAMETERS OR U. Reply with the parameter for formatting the job queue data set 
SYS1 .SYSJOBQE; R 00,'Q=(,F)' and signal EOB. If the date is incorrect, type R 00, 
'Q=(,F),DATE=yy.ddd,CLOCK=hh.mm.ss', where yy is the year (00-99), ddd is the day 
(001-366), hh is the hours (00-59), mm is the minutes (00-59), and ss is the seconds 
(00-59), and set the TOD switch on the console. 

1 5 . Reply U to the message SPECIFY JOBQUE PARAMETERS and signal EOB. 

16. Reply U to the message SPECIFY WITH SMF VALUES and signal EOB. 

17. You must enter the commands to start a reader, a writer, and an initiator. Type the 
following commands: 

MN JOBNAMES,T 
START RDR,00C 
START WTR,00E 
START INIT , , , classname 

ii 
If 00C and 00E are not the addresses of the reader and writer, enter the correct addresses. 

Initialize the Volume That is to Contain the Distribution Libraries 

18. The volume to be initialized must be varied offline. Place the following IEHDASDR 
control statements in the input device and enter a START RDR.00C command. The 
volume will be initialized. After IEHDASDR has been executed, the initialized volume 
must be varied online. 
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// VARY 151, OFFLINE 

//INIT JOB ACCT123 , PROGRAMMER ,MSGLEVEL=1 

//DLIB01 EXEC PGM=IEHDASDR,PARM='N=1' 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

ANALYZE TODD=( 151 ) , VT0O2 ,EXTENT=10 , X 

NEWVOLID=DLIB01 ,OWNERID=ID 

/* 



Copy the Distribution Libraries to a Direct-Access Volume 

19. Mount the distribution library tape. 

20. The IEBCOPY utility program is used to load the distribution libraries from tape to a 
direct-access volume. The IEBCOPY control cards are in the first file of the distribution 
library tape in the LOAD010 data set. When IEBCOPY is executed, it will allocate 
space to each of the distribution libraries and catalog them in the catalog of the 
generating system (in this case, the starter system). 

To access the IEBCOPY control cards for copying to either a 23 14, 23 19, or 3330, type 
the following: 

START RDR,182,LABEL=(,SL),DSNAME=LOAD010,VOL=SER=DLIBT1 

(If 182 is not the unit address of your tape drive, enter the correct address.) 

The control cards will be read in from tape and the reader will end and close. 

The IEBCOPY utility program will be executed. Completion of the preceding steps 
provides operable direct-access volumes with backup tapes. 

Punch the Utility Programs and IPL Text 

21 . This step is not necessary but may be performed at this time if you want the independent 
utilities and IPL text in card form. The independent utilities operate outside the control 
of the operating system and are loaded as card decks or card images on tape. The 
independent utilities and IPL text, however, must be of the same release level as the 
system you are generating. These programs are distributed in the SYS1.ASAMPLIB 
distribution library. Once these programs are punched you need only include them and 
they are ready for use. 

Use the IEBPTPCH utility program to punch the IBCDMPRS, IBCDASDI, and 
ICAPRTBL independent utility programs and the IPL text (IEAIPL00). Place the 
following IEBPTPCH control deck in the input device and enter a START RDR,00C 
command. 
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//JOBl JOB 
// EXEC 

//SYSUTl DD 

// 

//SYSUT2 DD 

//SYSPRINT DD 
//SYSIN DD 
PUNCH 
MEMBER 
MEMBER 
MEMBER 
MEMBER 

/* 



ACCT123 /PROGRAMMER , MSGLEVEL=1 

PGM=IEBPTPCH 

DSNAME=SYS1. ASAMPLIB, 

DISP= (OLD, KEEP) 

UNIT=00D 

SYSOUT=A 

* 

TYPORG=PO ,MAXNAME=4 

NAME=IBCDMPRS 

NAME=IBCDASDI 

NAME=ICAPRTBL 

NAME=IEAIPL00 



X 



A MEMBER card can be added to the above control statements for the sample exit 
routines that are contained in SYS1.ASAMPLIB for use if the System Management 
Facility (SMF) is to be used in the new VS2 system. By listing the cards that have been 
punched out from SYS1. ASAMPLIB, sample coding is provided for you to use as a 
reference while you are writing your own accounting routine. (For information on SMF, 
refer to OS/VS System Management Facilities (SMF). The SMF routines that are 
contained in SYS1. ASAMPLIB are: 

SMFE15, SMFE35, SMFSORT, SMFEXITS, SMFFRMT, and TESTEXIT. 

If you are including these sample programs to be punched out, be sure to adjust the 
MAXNAME field in the PUNCH control statement to show the revised number of 
member cards in the deck. 

List the Volume Table of Contents (VTOC) 

22. Before Stage I, you must allocate space to the three utility data sets that are used during 
Stage I and the OBJPDS utility data set that is used during Stage II by the assembler. If 
you choose to allocate this space on either the 3330 starter system volume or the 3330 
distribution library volume, you may want to list the VTOCs of the two volumes at this 
point to determine if enough space is available. (If you are using a 23 14/23 19, you will 
need to allocate this space on a utility volume.) 

Place the following IEHLIST control deck in the input device and enter a START RDR, 
00C command. 

If JOB2 is run immediately after JOBl (in step 21), eliminate the JOB2 card. 



//JOB 2 


JOB 


//STEP1 EXEC 


//SYSPRINT 


DD 


//SYSRES 


DD 


// 




//DLIBTAPE 


DD 


// 




//SYSIN 


DD 


LISTVTOC 




LISTVTOC 




/* 





ACCT 1 2 3 , PROGRAMMER , MSGLE VEL= 1 

PGM=IEHLIST 

SYSOUT=A 

UNIT=3330,DISP=OLD, X 

VOLUME=SER=STARTR 

UNIT= 3330 , DISP=OLD , X 

VOLUME=SER=DLIB01 
* 

VOL= 3330 =STARTR , FORMAT 
VOL=3330=DLIB01, FORMAT 
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Initialize the Volume That Will Contain the New VS2 System 

23. Mount the disk volume that is to contain the VS2 system that is to be generated. 

24. The volume to be initialized must be varied offline. Place the following 1EHDASDR 
control statements in the input device and enter a START RDR,00C command. The 
volume will be initialized and the IPL text will be written on the volume that is to be the 
new system residence volume. After IEHDASDR has been executed, the initialized 
volume must be varied online. 



// VARY 152, OFFLINE 



//INIT 


JOB 


//SYSRES 


EXEC 


//SYSPRINT 


DD 


//ASAMPLIB 


DD 


// 




//SYSIN 


DD 


ANALYZE 


TO] 



/' 



ACCT12 3, PROGRAMMER , MSGLE VEL= 1 

PGM=IEHDASDR 

SYSOUT=A 

DISP=OLD, 

DSNAME=SYS1. ASAMPLIB (IEAIPLOO) 



TODD=(152) ,VTOC=2,EXTENT=10, 
NEWVOLID= SYSRES , IPLDD=ASAMPLIB , 
OWNERID=ID 



X 



X 
X 



After you have selected and specified the system generation macro instructions, selected and 
specified the system data sets, and specified the control statements for initializing the required 
volumes, dumping the contents of the starter system tape to a direct-access volume, and copy- 
ing the distribution library tape to a direct-access volume, you are ready to specify the job 
control language required to execute Stage I. Refer to the "Stage I Input" section of "System 
Control Program Installation" for this information. After you have specified the Stage I job 
control language, you are ready to begin the actual processing. Refer to the beginning of this 
section ("System Generation Using the Starter System") and follow the procedures for execut- 
ing the utility programs using the control statements you coded earlier. Then, refer to "System 
Control Program Installation" for the information for Stage I execution. If you plan to add 
your own routines to the system to be generated, refer to "Adding User- Written Routines to 
the System Control Program," in this chapter before executing Stage I. 

System Generation Using an Existing VS2 System 

After your first system generation using the starter system, your existing VS2 system can be 
used as the generating system for system generation. When you use an existing VS2 system as 
the generating system you can either: 

Perform the system generation as the only job, or 
* Perform the system generation as one of several jobs in the job stream 

When you use the first method, you can modify the nucleus of the generating system (nucleus 
generation). When you use the second method, you cannot modify the generating system. 
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Preparation for System Generation Using an Existing VS2 System as the Generating System 

This section lists the procedures for using an existing VS2 system as the generating system in 
performing a system generation. 

Initialize the Volume That Will Contain the Distribution Libraries 

1 . Mount the volume onto which the contents of the distribution library tape will be copied. 

2. The volume to be initialized must be varied offline. Place the following IEHDASDR 
control statements in the input device and enter a START RDR, 00C command. After 
IEHDASDR has been executed, the initialized volume must be varied online. 



// VARY 151 , OFFLINE 



//DLIB01 
//INIT01 
//SYSPRINT 
//SYSIN 

ANALYZE 

/* 



OFFLINE 

JOB ACCTl 2 3 , PROGRAMMER , MSGLEVEL=1 

EXEC PGM=IEHDASDR,PARM= , N=1* 

DD SYSOUT=A 

DD * 

TODD=(151) ,VTOC= 00004 ,EXTENT= 00010 , 

FLAGTEST=NO ,NEWVOLID=DLIB01 



X 



Initialize the Volume That Will Contain the New VS2 System 

3. Mount the volume that is to contain the new VS2 system. 

4. The volume to be initialized must be varied offline. Place the following IEHDASDR 
control statements in the input device and enter a START RDR,00C command. After 
IEHDASDR has been executed, the initialized volume must be varied online. 



// VARY 152, OFFLINE 
//INIT JOB 
//SYSRES EXEC 
//SYSPRINT DD 
//ASAMPLIB 

// 
//SYSIN 

ANALYZE 



ACCT 1 2 3 , PROGRAMMER , MSGLE VEL= 1 

PGM=IEHDASDR 

SYSOUT=A 

DISP=OLD, 

DSNAME=SYS1 .ASAMPLIB ( IEAIPLO ) 
* 

TODD=(l£2) ,VTOC=2,EXTENT=10, 
NEWVOLID= SYSRES , IPLDD=ASAMPLIB , 
OWNERID=ID 



DD 



DD 



X 



X 
X 



/' 



Copy the Distribution Libraries to a Direct-Access Volume 

5. The IEBCOPY utility program is used to load the distribution libraries from tape to a 
direct-access volume. The IEBCOPY control statements are in the first file of the distri- 
bution library tape in the LOAD010 data set. When IEBCOPY is executed, it will allocate 
space to each of the distribution libraries and catalog them in the catalog of the generat- 
ing system (in this case, an existing VS2 system). 
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To access the IEBCOPY control statements for copying to either a 2314/2319 or 3330, 
type the following: 

START RDR,182,LABEL=(,SL),DSNAME=LOAD010,VOL=SER=DLIBT1 

(If 182 is not the unit address of your tape drive, enter the correct address.) 

The control statements will be read in from tape and the reader will end and close. 

The IEBCOPY utility program will be executed. Completion of the preceding steps 
provides operable direct-access volumes with a backup tape of the distribution libraries. 

After you have selected and specified the system generation macro instructions, selected and 
specified the system data sets, and specified the control statements for initializing the required 
volumes, dumping the contents of the starter system tape to a direct-access volume and copying 
the distribution library tape to a direct-access volume, you are ready to specify the job control 
language required to execute Stage I. Refer to the "Stage I Input" section of "System Control 
Program Installation" for this information. After you have specified the Stage I job control 
language, you are ready to begin the actual processing. Refer to the beginning of this section 
("System Generation Using an Existing VS2 System") and follow the procedures for executing 
the utility programs using the control statements you coded earlier. Then, refer to "System 
Control Program Installation" for the information for Stage I execution. If you plan to add 
your own routines to the system to be generated, refer to "Adding User-Written Routines to 
the System Control Program" in this chapter before you begin Stage I. 

Preparation for System Generation on the Generating System 

A nucleus generation can be performed against the generating system. The following proce- 
dures can be used to add a new nucleus to the generating system. 

• Modify the original Stage I macro instruction deck to include the new macro specifica- 
tions. The remaining macros need not be removed as they will be ignored (see "Examples 
of System Generation"). 

• Initialize the volume onto which the distribution library tape is to be copied. (See 
"Processing the Starter System and Distribution Library Tapes" in this chapter.) 

• Copy the distribution library tape to a direct-access volume. (See "Processing the 
Starter System and Distribution Library Tapes" in this chapter.) 

• Specify the job control language to run Stage I and Stage II. (See "System Control 
Program Installation".) 

• Run Stage I and Stage II. (Refer to "System Control Program Installation" for the pro- 
cedures to execute Stage I and Stage II.) 

Adding User-written Routines to the System Control Program 

During system generation, you can add your own routines to the new nucleus, SYS1 . LINKIB, 
andSYSl.LPALIB. 

Routines that are to be added to SYS1.NUCLEUS, SYS1.LINKLIB, or SYS1.LPALIB must be 
load modules residing in a cataloged partitioned data set in the generating system. That is, 
each routine must be compiled, link-edited, and placed in a cataloged partitioned data set. 
(Each load module must be a member of the data set.) The name of the partitioned data set 
must be of the form SYS 1. name. The name must consist of from 1 to 8 alphameric characters, 
the first character being alphabetic. The name of the partitioned data set and of the members 
that contain your routines are specified with system generation macro instructions. 
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The RESMODS macro instruction specifies load modules to be added to the nucleus during the 
nucleus link-edit step in Stage II (see "System Control Program Installation"). 

The LINKLIB macro instruction specifies load modules, such as accounting routines, to be 
added to SYS 1. LINKLIB during an IEBCOPY step in Stage II (see "System Control Program 
Installation"). These load modules become members of SYS 1. LINKLIB. 

The LPALIB macro instruction specifies load modules, such as type 3 or type 4 SVC routines 
and nonstandard label routines, to be added to SYS 1. LPALIB during an IEBCOPY step in 
Stage II (see "System Control Program Installation"). 

If SVCs are added to the nucleus or SYS 1. LPALIB, the SVCTABLE macro instruction must 
also be used. This macro instruction adds to the SVC table an entry that specifies the charac- 
teristics of each SVC added. 

Figure 16 is an example of adding a user-written routine to the new system control program. 
In the example, IGC255, a type 1 user-written SVC routine is to be included in SYS 1. NUCLEUS. 
In the first step, the CSECT is assembled and placed in a temporary data set, &&LOADSET. 
In the second step the CSECT is link-edited and becomes member IGC255 of SYS1.USERLIB, 
a partitioned data set that is cataloged in the generating system. During system generation the 
SVC will be included in the new nucleus by the following system generation macro instructions: 

RESMODS PDS=SYS1.USERLIB,MEMBERS=(IGC255) 



SVCTABLE 



SVC-255-D1 



//USERSVC 

//STEP1 

//SYSPRINT 

//SYSUT1 

//SYSUT2 

//SYSUT3 

//SYSLIB 

//SYSGO 

// 

//SYSIN 

IGC255 



The RESMODS, LINKLIB, LPALIB, and SVCTABLE macro instructions are described in the 
section "Specifying the New System Control Program." For a description of the control 
statements required by the assembler and the linkage editor, refer to OS/VS Assembler 
Programmer's Guide. 



JOB 
EXEC 
DD 
DD 
DD 
DD 
DD 
DD 



DD 

CSECT 

ENTRY 



MSGLEVEL=1 

PGM=ASMBLR , PARM= ' NODECK , OBJECT ' 
SYSOUT=A 

UNIT=SYSDA,SPACE=(CYL, (10,2)) 
UNIT=SYSDA , SPACE= (CYL ,(10,2)) 
UNIT=SYSDA,SPACE=(CYL, (10,2)) 
DSN=SYS1 .MACLIB , DISP=SHR 
DSN=&&LOADSET,UNIT=SYSDA,DISP=(,PASS) , 
SPACE=(CYL, (5,1,1) ) ,DCB=BLKSIZE=400 



IGC255 



X 



SOURCE STATEMENTS 



END 



/* 

Figure 16 (Part 1 of 2). Adding a user-written routine to the system 
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//STEP2 

//SYSPRINT 

//SYSUTl 

//SYSLMOD 

// 

// 
//SYSLIN 

/* 



EXEC 
DD 
DD 
DD 



DD 



PGM=LINKS , PARM= 'LIST, NCAL , XREF , RENT ' 
SYSOUT=A 

SPACE=(1024, (200, 
DSN=SYS1.USERLIB( 



=A 

;i024, (200,20) ) ,UNIT=SYSDA 
DSN=SYS1.USERLIB (IGC255) ,DISP= ( ,CATLG), 
VOL=SER=PACK01,SPACE=(CYL, (2,1,10)) , 
DCB=(RECFM=U,BLKSIZE=7294) ,UNIT=SYSDA 
DSN=&&LOADSET,DISP= (OLD, DELETE) 



X 
X 



Figure 16 (Part 2 of 2). Adding a user-written routine to the system 



Figure 17 is another example of adding a user-written routine to the system control program. 
In this example, a CSECT is to be added to SYS1 .NUCLEUS (member name IEANUC01). 
The CSECT consists of a series of constants describing the nucleus to be generated. This 
information will appear in SYSABEND, virtual-image, and stand-alone dumps as an additional 
means of identifying the nucleus of the System Control Program. 

During the first step, the CSECT is assembled and placed in a temporary data set 
(DSNAME=&LOADSET). The CSECT is link-edited in the second step and the resulting module 
becomes member IEAXYZ1 of the SYS 1. USER data set. SYS 1. USER is a partitioned data 
set residing on volume PACK01 and cataloged in the generating system. During system 
generation, the CSECT will be included in the nucleus by the following command: 



RESMODS PDS=SYS1.USER,MEMBERS= (IEAXYZl) 



//USER JOB 

//STEPl EXEC 

//SYSLIB DD 

//SYSUTl DD 

//SYSUT2 DD 

//SYSUT3 DD 

// 
//SYSPRINT DD 

//SYSGO DD 

// 

//SYSIN 

IEAXYZl 



MSGLEVEL=1 

PGM=ASMBLR , PARM= ' NODECK , OBJECT ' 

DSNAME=SYS1 . MACLIB , DISP=OLD 

UNIT=SYSSQ,SPACE=(1700, (400,50) ) 

UNIT=SYSSQ,SPACE=(1700, (400,50) ) 

UNIT= (SYSSQ , SEP= (SYSUTl , SYSUT2 , SYSLIB) ) , 

SPACE=(1700, (400,50) ) 

SYSOUT=A 

DSNAME=&LOADSET,UNIT=SYSSQ,SPACE=(80, (200,50)) , 

DISP= (MOD, PASS) 



X 



X 



DD 
CSECT 
DC 
DC 
DC 
DC 
DC 
END 



C ' XXXXXXXXXX-NUCLEUS ID CSECT-XXXXXXXXXX' 

C SYSTEM CONTROL PROGRAM GENERATED 7/1/73' 

C OWNER — DEPT. D58 ' 

C NUCLEUS — 01' 

C ' XXXXXXXXXX-END ID CSECT-XXXXXXXXXX' 



/' 



Figure 17 (Part 1 of 2). Preparing a user-written nucleus-identification load module 
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//STEP 2 EXEC PGM=LINKS,PARM=(XREF,LIST,NCAL) 



//SYSLIN DD 
//SYSLMOD DD 

// 

//SYSUTl DD 

// 
//SYSPRINT DD 

/* 



DSNAME=&LOADSET,DISP= (OLD, DELETE) 

DSNAME=SYS1.USER(IEAXYZ1) ,UNIT=2314 ,DISP= ( ,CATLG) , 
VOLUME=(, RETAIN ,SER=PACK01) ,SPACE= (1024 , (50,20,5)) 
UNIT=(SYSDA,SEP= (SYSLIN, SYSLMOD) ) , 
SPACE=(1024, (50,20,5) ) 
SYSOUT=A 



X 



X 



Figure 17 (Part 2 of 2). Preparing a user-written nucleus-identification load module 
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SYSTEM CONTROL PROGRAM INSTALLATION 



The first section of this chapter presents an explanation of Stage I and discusses Stage I input, 
Stage I processing, and the job stream that is produced. The second section presents an ex- 
planation of Stage II and discusses Stage II input, job stream processing, and Stage II output. 
Also included are procedures that you may need to perform after system generation. 



Stage I: Producing the Job Stream 



Stage I Input 



In Stage I, the macro instructions are assembled and analyzed for errors. If errors are found, 
error messages are written and the job stream is not produced. If no errors are found, a job 
stream consisting of job control language and control statements is produced. During Stage II 
these statements are used to select and process components from the distribution libraries and 
user-written components to form the new VS2 System Control Program. 

It is possible to produce a job stream even though there are errors in the Stage I macros. Refer 
to Appendix E for the macro that can be used to override any errors that may be found during 
execution of Stage I. 



The input deck required for Stage I consists of job control language statements and system 
generation macro instructions. The sequence of the cards in the deck and the job control 
language statements are shown in Figure 18. 

The input deck for Stage I must contain the following if the system generation program is 
executing as an independent job: 

. A JOB statement with any parameters required by your installation. If the system 
generation process immediately follows the space allocation and cataloging of system 
data sets using IEHPROGM, this card is not to be specified. 

An EXEC statement with PGM = ASMBLR. 

A SYSLIB DD statement that allocates the SYS 1 . AGENLIB macro library to this job 
step. 

Three DD statements names SYSUT1, SYSUT2, and SYSUT3 that are used to allocate 
space to the three utility data sets required for Stage I. (Refer to Figure 18 for space 
allocation.) 

. A SYSPUNCH DD statement defining the data set that is to contain the job stream pro- 
duced during Stage I. 

. A SYSPRINT DD statement defining the output classname. 

A SYSIN DD * statement 

# The system generation macro instructions 

# An END statement 
. A /* card 
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MSGLEVEL=1 

PGM=ASMBLR 

DSNAME=SYS1.AGENLIB,DISP=SHR 

UNIT=unit address ,SPACE= (space) 

UNIT=unit address / SPACE= (space) 

UNIT=unit address, SPACE= (space) 

UNIT=uni t addr es s , LABEL= ( , NL) 

SYSOUT=A 
* 

system generation macro instructions 
END 



//USER 


JOB 


// 


EXEC 


//SYSLIB 


DD 


//SYSUTl 


DD 


//SYSUT2 


DD 


//SYSUT3 


DD 


//SYSPUNCH 


DD 


//SYSPRINT 


DD 


//SYSIN 


DD 



/' 



Figure 18. Input deck for Stage I 



Figure 19 shows the values to be given to the SPACE parameter of each of the DD statements 
that define the utility data sets according to the type of direct-access volume on which they may 
reside. To determine if there is enough space available on the direct-access volume, list its 
volume table of contents (VTOC) before Stage I using the IEHLIST utility program. (See 
"Preparing for System Generation.") 



Device Type 


DD Statement 


SYSUT1 


SYSUT2 


SYSUT3 


OBJPDS 1 


2305 or 3330 


3,2 


5,2 


8,2 


5,1,12 


2314 or 2319 


15,2 


10,2 


16,2 


7,1,12 



1 

The OBJPDS utility data set is used during Stage li. 
Figure 19. Space allocation (in cylinders) for the utility data sets 



Stage I Execution 



Stage I Output 



The system generation macro instructions are executed as one assembler job. During execution 
of the Stage I input, the macro instructions are assembled and analyzed for valid parameters 
and dependencies upon other macro instructions. 

For the macro instructions to be executed, the volumes containing the starter system and 
distribution libraries must be mounted. 



If invalid macro instructions are found during Stage I execution, error messages are printed 
(see Appendix C) and the job stream is not produced. (For information on restarting Stage I, 
refer to "Restart Procedures.") If there are no errors, the job stream is produced as punched 
cards, as card images on tape or in a data set on disk according to what you specified in your 
Stage I SYSPUNCH DD statements. In addition to the job stream, Stage I also produces a 
documentation listing. This is a printout of the expansion of all the macro instructions that 
you specified, including the PUNCH statements that comprise the input to Stage II. 
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When you have completed State I and produced a job stream, you are ready to begin 
Stage II. 



Stage II: Processing the Job Stream 



Stage II Input 



In Stage II, the job stream produced during Stage I is processed as follows: 

• Selected modules are assembled. 

• The linkage-editor combines the modules that are to be included in the resident portion 
of the control program (the nucleus). 

• The linkage-editor processes selected modules to construct members of the new VS2 
system data sets. 

• Utility programs complete the construction and initialization of the system data sets 
that make up the new VS2 system. 

The completion of Stage II results in a System Control Program that reflects what was specified 
in the system generation macro instructions. 



The input for Stage II consists of the control statements required to catalog and allocate space 
for the utility data set, OBJPDS, and the job stream that is the output from Stage I. 



Allocating Space for and Cataloging the OBJPDS Utility Data Set 

You can catalog and allocate space for the OBJPDS utility data set at the same time you catalog 
and allocate space for the system data sets if you are using the IEHPROGM utility program (see 
"Selecting the New System Data Sets"). If you are using the DATASET macro instruction to 
catalog and allocate space for the system data sets, you will need to catalog and allocate space for 
OBJPDS before Stage II is executed. Figure 20 shows the job control statements used to catalog 
and allocate space for the OBJPDS utility data set. Figure 19 gives the space requirements for 
the utility data set. If Stage II immediately follows Stage I, the JOB card is not specified. 



//OBJPDS 


JOB 


MSGLEVEL=1 


//■ 


EXEC 


PGM=IEHPROGM 


//OBJPDS 


DD 


DSNAME=SYS1. OBJPDS, SPACE= (space) , X 


// 




DISP=(,CATLG) ,UNIT=(unit address) ,X 


// 




VOLUME= ( , RETAIN , SER=ser ial number ) 


//SYSPRINT 


DD 


DUMMY 


//SYSIN 

/* 

Figure 20. Job cont 


DD 


DUMMY 


:rol statements for allocating space to and cataloging the OBJPDS utility 


data set 







The Job Stream 



If no error messages are printed during Stage I, the job stream is produced on the SYSPUNCH 
data set. The job stream is the input to Stage II. 

The job stream contains several JOB statements, each followed by one or more EXEC state- 
ments. Each EXEC statement is followed by its associated DD statements and other data 
required to execute the assembler, linkage editor, and utility programs during Stage II. 
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The Job Statement. The format of the Stage II JOB statements that are produced by the 
system generation process is: 

//SYSGENnn JOB1, "SYSTEM GENERATION",CLASS=&SGCTRLC(42), X 

MSGCLASS=&SGCTRLC(4 1 ) ,MSGLEVEL=1 

The nn represents sequential identification numbers supplied by the system generation process. 
If a value other than 'SYS 1' is specified in the INDEX parameter of the GENERATE macro 
instruction, that value will be substituted for 'SYSGEN' in the jobname field. &SGCTRLC(42) 
will be substituted with the appropriate job class and &SGCTRLC(41) will be substituted with 
the appropriate output class. 

You may choose to use your own JOB statements by changing the job name or the accounting 
information on the JOB statement before Stage I. You can do this by using the IEBUPDTE 
utility program to modify the JOB statement information that is contained in the 
SYS1.AGENLIB distribution library. (Refer to OS/VS Utilities for information on using the 
IEBUPDTE utility program.) 

When modifying the JOB statement, the name parameter must be jobname&SGCTRLA(3). 
Jobname consists of 1 through 6 alphameric or national (#,@, or $) characters, the first 
character being alphabetic or national. &SGCTRLA(3) is a counter that will be incremented by 
the system and which produces unique jobnames. (For information on coding the JOB state- 
ment, refer to OS/VS JCL Reference) 

Figure 21 is an example of creating a unique JOB statement. In this example, the jobname will 
be 'SYS#10nn.' The input class for the job stream will be 'C, and the output class for the 
system messages will be 'C. 

Col 

i 9 

(78700, J22) , NAME, MSGLEVEL= (1,1) 

PGM= IEBUPDTE , PARM=MOD 

SYSOUT=A 

DSN=SYSl.AGENLIB,DISP=OLD 

DSN=SYSl.AGENLIB,DISP=OLD 
* 

NAME=JOBCARD , LIST=ALL 
NEW1=10000,INCR=10000 



SGGBLPAK 

PUNCH '//SYS#10&SGCTRLA(3) JOB (78700, J22), X 
NAME ,MSGLEVEL=1 , CLASS=C ,MSGCLASS=C 
MEND 
. / ENDUP 
/* 



1 3 ' 


9 


//JOBA 


JOB 


//UPDTE 


EXEC 


//SYSPRINT DD 


//SYSUT1 


DD 


//SYSUT2 


DD 


//SYSIN 


DD 


./ 


REPL 


. / NUMBER 


I 


MACRO- 


JOBCARD 




COPY 



Figure 21 . Creating unique job statements for the Stage II input deck 
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The EXEC Statement The format of the Stage II EXEC statements that are produced by the 
system generation process is: 



or 



//SGxx EXEC PGM=program[,COND=condition][,PARM=value(s)] 
//SGxx EXEC procname[,PARM=value(s)] 



where 

SGxx is the step name. The xx represents a sequential identification number supplied 

by the system generation process. 

PGM indicates the name of the program being executed. The names are IFCDIPOO, 

IEHPROGM, IEHLIST, IEBUPDTE, IFCERCPO and IQADCMOO. The programs 
are executed in the order in which they are discussed in "Stage II Execution!' 
Some of the programs are executed several times. 

procname is the name of the procedure being executed. The names are ASMS and LINKS. 
The procedures are executed in the order in which they are discussed in "Stage II 
Execution." Some of the procedures are executed several times. 

COND specifies the conditions for executing or bypassing the job step according to the 

success or failure of the previous step in the job. If the previous step was unsuccess- 
ful, the remaining steps are bypassed and the next job is initiated. 



PARM specifies any parameter information that may be required for that job step. 



Stage II Execution 



This section discusses the programs that are executed and their sequence of execution in 
creating a VS2 System Control Program. Also in this section is a list of the components of the 
distribution libraries, the names of the distribution libraries, and the system data sets where the 
components are placed during Stage II execution. 

During Stage II execution, the job stream (job control language and utility control statements) 
assembles, link-edits, and copies specific modules from the distribution libraries and user 
libraries into system data sets that were allocated on the new system volume(s) to form the 
new VS2 system. 

Execution of the job stream occurs in thirteen jobs for a complete system generation. For a 
nucleus or I/O device generation, job stream execution occurs in less than thirteen jobs. For 
those jobs that are executed, the sequence of execution is the same as in a complete system 
generation. Also, the number of job steps in a job may vary according to what is specified in 
the macro instructions. 

The following example illustrates the execution of the job stream for a complete system 
generation. 
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Job 1. If DATASET macros were specified, the IEHPROGM utility program catalogs and 
allocates space for the system data sets. If the system data sets were cataloged and space was 
allocated before Stage II this job step does not occur. 



//SYSGEN1 JOB 
//SGI EXEC 



IEHPROGM 



SYSCTLG 

SYS1.DCMLIB 

SYS1.DSSVM 

SYS1.IMAGELIB 

SYS1.SAMPLIB 

SYS1.LINKLIB 

SYS1.MACLIB 

SYS1. NUCLEUS 

SYS1.PARMLIB 

SYS1.PROCLIB 

SYS1.SVCLIB 

SYS1.LPALIB 

SYS1.SYSJOBQE 

SYS1.TELCMLIB 



System 

Residence 

Volume 



If this was generation of a TSO system, the following data sets would also be cataloged and have 
space allocated for them: 

SYS1.CMDLIB 
SYS1.BRODCAST 
SYSl.'HELP 
SYS1.UADS 

Job 2. Modules are assembled, based on parameter values specified in the macro instructions 
and from SYS1 .AMODGEN, and placed in the object-module utility data set (OBJPDS). 



//SYSGEN2 JOB 
//SGI EXEC ASMS 



//SG50 



EXEC ASMS 



Stage i Output 
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Job 3. The IEBCOPY utility program copies modules from SYS1.AMACLIB and 
SYS1.ATCAMMAC (if TCAM was specified) to SYS1 .MACLIB in the new system. It also 
copies SYS1 .ALPALIB, SYS 1 .APARMLIB, SYS1 . APROCLIB, and SYS1 . ASAMPLIB to 
SYS1.LPALIB, SYS1 .PARMLIB, SYS1 .PROCLIB, and SYS1.SAMPLIB, respectively, in the 
new system. If this was the generation of a TSO system, SYS1 .TSOMAC, SYS1 . AHELP, and 
SYS1 . AUADS would be copied to SYS1 .MACLIB, SYS1 .HELP, and SYS1 .UADS, respectively. 



//SYSGEN3 JOB 

//SGI EXEC IEBCOPY 



SYS1.ATCAMMAC 



SYS1.AMACLIB 



SYS1. MACLIB 



SYS1. ALPALIB 



SYS1.LPALIB 



SYS1. APROCLIB 



SYS1. PROCLIB 



SYS1. APARMLIB 



SYS1. PARMLIB 



SYS1. ASAMPLIB 



SYS1.SAMPLIB 
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Job 4. This job catalogs and allocates space for SYS1 XOGREC on the new system residence 
volume (TSO and non-TSO generation). 



//SYSGEN4 JOB 
//SGI EXEC 
//SG2 EXEC 



IFCDIPOO 
IEHPROGM 



SYS1.LOGREC 



Job 5. The IEBCOPY utility program copies the service aid programs and the loader program 
from the distribution libraries to SYS1 .LINKLIB in the new system (TSO and non-TSO 
generation). 



//SYSGEN5 JOB 
//SGI EXEC 



IEBCOPY 



Distribution 
Libraries 



SYS1. LINKLIB 
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Job 6. The IEBCOPY utility program copies modules from the distribution libraries to 
SYS1.LPALIB, SYS1.LINKLIB, SYS1.SVCLIB, and SYS1.TELCMLIB. 



//SYSGEN6 JOB 

//SGI EXEC IEBCOPY 



Distribution 
Libraries 



SYS1.LPALIB 



SYS1.LINKLIB 



SYS1.SVCLIB 



SYS1.TELCMLIB 



Job 7. The IEBCOPY utility program copies modules from the distribution libraries and user- 
defined libraries to SYS1 .LINKLIB, SYS1 .LPALIB, SYS1 .NUCLEUS, and SYS1.IMAGELIB. 



//SYSGEN7 JOB 

//SGI EXEC IEBCOPY 



SYSLuseNinklib 



SYS1. LINKLIB 
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Job 8. The IEBUPDTE utility program adds members to the IEASYSOO and IEAFIX01 
lists in SYS1 .PARMLIB. The members that are added are specified in the CTRLPROG, 
LINKLIB, PAGE and SCHEDULR macro instructions (TSO and non-TSO generation). 



//SYSGEN8 JOB 

//SGI EXEC IEBUPDTE 



//SG2 



EXEC IEBUPDTE 



CTRLPROG 
LINKLIB 
PAGE 
SCHEDULR 



SYS1. PARMLIB 



Job 9. Modules from SYS1.AMODGEN are assembled and placed in the object-module utility 
data set (OBJPDS). Modules from the distribution libraries, the OBJPDS utility data set, and 
user-libraries are then link-edited and placed in SYS 1. NUCLEUS (TSO and non-TSO generation). 



//SYSGEN9 
//SGI 



//SG3 
//SG4 



JOB 
EXEC 



EXEC 
EXEC 



ASMS 



ASMS 
LINKS 



Distribution 
Libraries 



SYS1.AMODGEN 



OBJPDS 



SYSI.usernuc 




SYS1. NUCLEUS 
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Job 10. Modules from SYS1. AMODGEN are assembled and placed in the object-module utility 
data set (OBJPDS). In a TSO-generation, modules would also be assembled from the 
SYS1.AMACLIB, SYS 1. AMODGEN, and SYS1.ATSOMAC distribution libraries. 



//SYSGEN10 JOB 
//SGI EXEC 



//SG10 



EXEC 



ASMS 



ASMS 



SYS1. AMODGEN 



OBJPDS 



Job 11. Modules from SYS1. AMODGEN and SYS1.AMACLIB are assembled and placed in 
the object-module utility data set (OBJPDS). These modules and modules from the distribu- 
tion libraries are then link-edited and placed in SYS1 .IMAGELIB, SYS1.LPALIB, 
SYS1.LINKLIB, SYS 1. NUCLEUS, and SYS1 .DCMLIB. In a TSO-generation, this job step 
would also include link-edits into SYS1 .CMDLIB. 



//SYSGEN11 
//SGI 


JOB 
EXEC 

• 


ASMS 


//SG3 
//SG4 


• 

• 

EXEC 
EXEC 

• 


ASMS 
LINKS 


//SG51 


• 
• 

EXEC 


LINKS 



SYS1. AMODGEN 



SYS1.AMACLIB 




SYS1. IMAGELIB 



SYS1.LPALIB 



SYS1.LINKLIB 



SYS1. NUCLEUS 



SYS1. DCMLIB 



Job 12. The IQADCMOO utility program formats the DSS paging system data set. 



//SYSGEN12 JOB 

//SGI EXEC IQADCMOO 



SYS1.DSSVM 



System Control Program Installation 159 



I Job 13. The IEHPROGM utility program renames the index of the system data sets to SYS1 . 
if you specified other than SYS1 . in the INDEX parameter of the GENERATE macro instruc- 
tion (complete, nucleus, and I/O device generation). The IEHLIST utility program lists the 
system catalog, the directories of the partitioned data sets in the new VS2 system, and the 
VTOC (complete and I/O device generation). 



//SYSGEN13 JOB 
//SGI EXEC 
//SG2 EXEC 



IEHPROGM 
IEHLIST 



LISTCATLG 

LISTPDS 

LISTVTOC 



Figure 22 lists the components of the distribution libraries, the names of the distribution 
libraries from where the components are obtained, and where the components of the distribu- 
tion libraries are placed during Stage II. 



Component 


Obtained from 


Placed in 


Access Methods 


SYS1.AOSD0 


SYS1.LPALIB 


BDAM 


SYS1.AOSD7 


SYS1.LPALIB 


BTAM 


SYS1.AOS06 
SYS1.AOS20 
SYS1.AOS21 


SYSl.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 
SYS1.TELCMLIB 


Data Management Routines 


SYS1.AOSD0 


SYSl.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 


DIDOCS 


SYS1.AMODGEN 
SYS1.AOSC4 


SYS1.DCMLIB 
SYS1.LPALIB 


Direct- Access Device 
Space Management 
(DADSM) 


SYS1.AOSD0 


SYS1.LPALIB 


EREP 


SYS1.AOSCD 


SYSl.LINKLIB 


ERP 


SYS1.AOSCD 


SYS1.LOGREC 


Generalized Trace Facility 
(GTF) 


SYS1.AOS11 
SYS1.AOSC5 
SYSl.AMACLIB 


SYSl.LINKLIB 
SYS1. NUCLEUS 
SYS1.MACLIB 


Graphic Programming 
Services 


SYS1.AOS07 
SYS1.AOSG0 


SYSl.LINKLIB 
SYS1. LPALIB 
SYS1. NUCLEUS 



Figure 22 (Part 1 of 4). The components of the distribution libraries and where they are placed 
in the system 
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Component 


Obtained from 


Placed in 


Independent Utilities 

1 PL Text 

SMF Sample Exit Routines 


SYS1.ASAMPLIB 


SYS1.SAMPLIB 


Installation Verification 
Procedure 


SYS1.ASAMPLIB 


SYS1.SAMPLIB 


IOS 


SYS1.AOSCA 
SYS1.AOSG0 
SYS1.AOSC5 
SYS1.AOSD0 
SYS1.AOSD7 


SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 


ISAM 


SYS1.AOSD8 


SYS1.LPALIB 
SYS1. NUCLEUS 


Linkage Editor 


SYS1.AOS04 
SYS1.AMODGEN 


SYSl.LINKLIB 


Loader 


SYS1.AOS05 
SYS1.AMODGEN 


SYSl.LINKLIB 


Macro Library 


SYS1.AMACLIB 
SYS1.ATCAMMAC 


SYS1.MACLIB 


On-Line Test Executive 
Program (OLTEP) 


SYS1.AOS06 
SYS1.AOSC5 


SYSl.LINKLIB 
SYS1.LPALIB 


Open/Close/End-of-Volume 


SYS1.AOSD0 
SYS1.AOSD8 


SYSl.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 


Overlay Supervisor 


SYS1.AOSC2 


SYS1.LPALIB 


Parameter Library 


SYS1.APARMLIB 


SYS1.PARMLIB 


Procedure Library 


SYS1.APROCLIB 


SYS1.PROCLIB 


Recovery Management 


SYS1.AOSCD 
SYS1.AOSCE 


SYSl.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 


Service Aids 


SYS1.AOS11 
SYS1.AOS12 
SYS1.AOSCD 
SYS1.AMACLIB 


SYSl.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 



Figure 22 (Part 2 of 4). The components of the distribution libraries and where they are placed 
in the system 
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Component 


Obtained from 


Placed in 


Scheduler 


SYS1.AOSC6 
SYS1.AOSB3 
SYS1.AOS00 
SYS1.AOSC5 
SYS1.AOS21 
SYS1.AOSCE 
SYS1.AOST4 
SYS1.AMODGEN 


SYSI.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 


Stage 1 System Generation 
Macro Definitions 


SYS1.AGENLIB 


Not applicable 


Stage 1 1 System Generation 
Macro Definitions 


SYS1.AMODGEN 


Not applicable 


Supervisor 


SYS1.AOSC5 
SYS1.AOS10 
SYS1.AOSD0 


SYSI.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 


System Management 
Facility 


SYS1.AOS00 
SYS1.APARMLIB 


SYSI.LINKLIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 


OS/VS Assembler 


SYS1.AOS03 


SYSI.LINKLIB 


TCAM 


SYS1.AOS21 


SYSI.LINKLIB 
SYS1.LPALIB 
SYS1. NUCLEUS 
SYS1.SVCLIB 
SYS1.TELCMLIB 


TCAM Macro Definitions 


SYS1.ATCAMMAC 


SYS1.TELCMLIB 


TSO Data Management 
Routines 


SYS1.AOST3 
SYS1.AOS21 


SYS1.CMDLIB 
SYS1.DCMLIB 
SYSI.LINKLIB 
SYS1.LPALIB 


TSO Linkage Editor 
Prompter 


SYS1.ACMDLIB 


SYS1.CMDLIB 


TSO Editor 


SYS1.ACMDLIB 
SYS1.ATSOMAC 
SYS 1. AM ACL IB 


SYS1.CMDLIB 
SYS1.DCMLIB 
SYSI.LINKLIB 
SYS1.LPALIB 


TSO Scheduler 


SYS1.AOST4 
SYS1.ACMDLIB 
SYS1.AMACLIB 
SYS1.ATSOMAC 


SYS1.CMDLIB 
SYSI.LINKLIB 
SYS1.LPALIB 



Figure 22 (Part 3 of 4). The components of the distribution libraries and where they are placed 
in the system 
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Stage II Output 



Component 


Obtained from 


Placed in 


TSO Supervisor 


SYS1.AOST4 


SYS1.LINKLIB 

SYS1.LPALIB 

SYS1.SVCLIB 


TSO Test 


SYS1.ACMDLIB 


SYS1.CMDLIB 


TSO Type 1 Utilities 


SYS 1. ACM D LIB 

SYS1.AOSB3 

SYS.1.AOST4 

SYS1.ATSOMAC 

SYS1.AMACLIB 


SYS1.CMDLIB 
SYS1.LINKLIB 
SYS1.LPALIB 


UCS Images 


SYS1.AOSD0 


SYS1.IMAGELIB 


Utility Programs 


SYS1.AOSU0 


SYS1.LINKLIB 
SYS1.LPALIB 


VSAM 


SYS1.AOSA0 


SYS1,LPALIB 



Figure 22 (Part 4 of 4). The components of the distribution libraries and where they are placed 
in the system 



The output from Stage II is your new VS2 System. The new VS2 system that is generated is a 
System Control Program. Program Products are neither distributed nor generated with the 
System Control Program. Manuals that describe specific Program Products contain the pro- 
cedures and requirements for installing them. 

Stage II also produces a documentation listing. This is a printout of all the steps executed by 
the assembler, the linkage editor, and the utility programs. 

Your new VS2 system should be tested to eliminate any possible malfunctions. Your VS2 
system can be tested by the using the installation verification procedure (IVP). For the infor- 
mation necessary to use IVP, see "Testing the New System Control Program." 



Removing the Names of the Distribution Libraries 
from the Catalog of the Generating System 



After you have successfully installed your new VS2 system using an existing VS2 system or 
after you have performed a nucleus generation against the generating system, you will need to 
remove the names of the distribution libraries from the catalog of the generating system. This 
can be done by using the IEHPROGM utility program. Place the following IEHPROGM control 
statements in the input device and enter a START RDR. OOC command. (If 00C is not the 
address of your input device, enter the correct address.) An UNCATLG statement must be 
specified for each entry to be removed from the catalog. The CVOL parameter should point 
to the catalog from which the entries are to be removed. 
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//UNCATLG 


JOB 






// 


EXEC 


PGM=IEHPROGM 




//SYSPRINT 


DD 


SYSOUT=A 




//CATLG 


DD 


UNIT=3330,DISP=OLD, 


X 


// 




VOLUME=SER=volumeserial 




//SYSIN 


DD 


* 




UNCATLG 




DSNAME=dsname, 
CVOL=device=volumeserial 


X 


/* 









Renaming the New Nucleus 



If you performed a nucleus generation against the generating system, you may want to make 
the newly created secondary nucleus the primary nucleus (IEANUC01). This can be done in 
two ways: 

. Rename the old primary nucleus and rename your new primary nucleus to IEANUC01 , or 
. Specify the new nucleus at IPL 
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RESTART PROCEDURES 



The system generation process may come to an unsatisfactory completion because of errors 
that occurred during Stage I or Stage II. This chapter contains the information necessary to 
restart system generation. 

The first section of this chapter discusses the most common causes of error during Stage I and 
the restart procedures for Stage I. 

The second section of this chapter discusses the most common causes of error during Stage II, 
the restart techniques, and the reallocation of data sets. 



Restarting Stage I 



The most common causes of error during Stage I are keypunching errors in the input deck and 
contradictory or invalid specifications in the macro instructions. 

Keypunching errors are indicated by system generation error messages or assembler error 
indications. Invalid specifications are indicated with the system generation error messages (see 
Appendix C) printed in the SYSPRINT data set. If any errors are found during Stage I, the 
job stream is not produced. 

Stage I consists of a single assembly of the system generation macro instructions. It can be 
restarted only from the beginning. To restart Stage I, correct the errors in the input deck and 
resubmit the job. 

Restarting Stage II 

The most common causes of error during Stage II are: 

. Machine interruptions and noncontinuous machine time. 

. Faulty space allocation of the system data sets during the preparation for system 
generation. 

. Errors in the input deck that cannot be detected during Stage I. For example, if 
SYS 1 .NUCLEUS was allocated space on volume 111111 during the preparation for 
system generation, and if RESVOL=Al 1111 was specified in the GENERATE macro 
instruction, an error would occur. 

. Procedural errors, such as improper volume mounting. 



Restart Techniques 



Stage II can be restarted at the beginning of any job or job step. If any statements in the job 
stream are to be changed, the job stream must be on cards. If no statements are to be changed, 
the IEBEDIT utility program can be used to restart a job stream. Procedures discussed in the 
section "Guidelines for Restarting Stage II" may need to be performed before restarting 
Stage II. This section discusses the techniques used for restarting the job stream after any other 
necessary operations have been performed. The topics include restarting from cards, punching 
the job stream, and restarting from tape or disk. 
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Restarting From Cards 

If the job stream is on cards, you can restart a job step by placing a JOB card ahead of the job 
step's EXEC card and entering a START RDR command for the card reader. 

Punching the Job Stream 

If the unit (SYSPUNCH) specified for the job stream during Stage I was not a card punch, the 
IEBPTPCH utility program can be used to punch the job stream. Figure 23 shows the state- 
ments required to punch the job stream using IEBPTPCH. In this example, the underlined fields 
may require modification for different installations. 



//PUNCH 


JOB 






// EXEC 


PGM=IEBPTPCH 




//SYSUT1 


DD 


UNIT=182 ,LABEL= ( ,NL) , 


X 


// 




VOLUME=SER=EXLABL ,DISP=OLD 




//SYSUT2 


DD 


UNIT=2540-2 




//SYSPRINT 


DD 


SYSOUT=A 




//SYSIN 


DD 


* 




PUNCH 




TYPORG=PS ,MAXFLDS=1 




RECORE 


) 


FIELD=(80) 




/* 








Figure 23. Punching 


the job 


stream on any 2540 card read punch 





When you use the IEBPTPCH utility program to punch the job stream, consider the following: 

• The value of the UNIT parameter of the SYSUT1 DD statement is the specific unit 
address of the magnetic tape drive or direct-access storage device on which the job stream 
resides. Unless the job stream tape or disk has been demounted, the value of this UNIT 
parameter is the same as the value of the UNIT parameter of the SYSPUNCH DD state- 
ment in the input deck for Stage I. If the job stream is on disk, the LABEL parameter 
must specify a standard label and a DSNAME parameter must be specified. 

• The value of the VOLUME parameter of the SYSUT1 DD statement is either any external 
serial number you have assigned to the job stream tape reel or the volume serial number 
of the tape or direct -access storage device. The system will issue a MOUNT command 
for the specified volume on the magnetic tape or direct -access storage device indicated 

by the UNIT parameter. 

• You can specify sequence numbers for the punched cards by specifying the CDSEQ or 
CDINCR parameters in the PUNCH control cards of the IEBPTPCH input deck. (Refer to 
OS/VS Utilities for information about the CDSEQ and CDINCR parameters). 

Restarting From Tape or Disk 

The IEBEDIT utility program can be used to restart Stage II from any job step after the first 
when the job stream is on tape or disk. To restart from the first job step, issue a START RDR 
command for the tape drive or direct-access storage device that contains the job stream. 

IEBEDIT creates a new job stream by editing and selectively copying the job stream provided 
as input. The IEBEDIT utility program can copy an entire set of jobs, including JOB statements 
and associated job step statements, or selected job steps in a job. Figure 24 shows the control 
statements required by IEBEDIT. 
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//RESTART 


JOB 


// 


EXEC 


//SYSPRINT 


DD 


//SYSUTl 


DD 


// 




// 




// 




//SYSUT2 


DD 


// 




// 




// 




//SYSIN 


DD 


EDIT 


ST, 


or EDIT 


ST. 



PGM=IEBEDIT 

SYSOUT=A 

UNIT=xxxx , LABEL= ( , NL ) , X 

VOLUME=SER=serial,DISP= (OLD, KEEP) ,X 

DSN=dsname , X 

DCB= (DCB information) 

UNIT=xxxx , LABEL= ( , NL) , X 

VOLUME=SER=serial,DISP=(,KEEP) , X 

DSN=dsname , X 

DCB=(DCB information) 
* 

START=SYSGENnn,STEPNAME=SGxx [ ,NOPRINT] 
START=S YSGENnn , TYPE=INCLUDE , X 

STEPNAME=(SGxx[,SGxx] . . .) [,NOPRINT] 
or EDIT START=S YSGENnn, TYPE=EXCLUDE, X 

STEPNAME= (SGxx [ ,SGxx] . . . ) [ ,NOPRINT] 

/* 

Figure 24. Control Statements for IEBEDIT when the job stream is on tape 



When you use the IEBEDIT utility program to restart Stage II consider the following: 

. The value of the UNIT parameter of the SYSUTl DD statement is the unit address of the 
magnetic tape drive or direct-access storage device on which the job stream resides. 
Unless the job stream tape or disk had been demounted, the value of the UNIT parameter 
is the same as the value of the UNIT parameter of the SYSPUNCH DD statement in the 
Stage I input deck. If the job stream is on disk, the LABEL parameter must specify a 
standard label. 

• The value of the VOLUME parameter of the SYSUTl DD statement is either any serial 
number you have assigned to the job stream tape reel or the volume serial number of the 
tape or direct-access storage device. The system will issue a MOUNT command for the 
specified volume on the magnetic tape drive or direct-access storage device indicated with 
the UNIT parameter. 

• The value of the UNIT parameter of the SYSUT2 DD statement is the unit address of 
a magnetic tape drive or direct-access storage device. If the job stream is on disk, the 
LABEL parameter must specify a standard label. 

• You can specify one or more EDIT statements when executing IEBEDIT. If the TYPE 
parameter is omitted, STEPNAME specifies the first job step in the job specified by the 
START parameter to be placed in the new job stream. 

If TYPE=INCLUDE or TYPE=EXCLUDE is specified, STEPNAME specifies the j ob 
steps to be included or excluded, respectively, from the new job stream. Individual job 
steps and sequences of job steps can be specified for inclusion or exclusion. For example: 

START=SYSGEN9,TYPE=INCLUDE,STEPNAME=(SG3,SG6-SG9) 

indicates that job steps 3,6,7, 8, and 9 of job 9 are to be included in the restart of system 
generation. 
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• NOPRINT must be included if you do not want a listing of the new job stream. After 
the new job stream is created, a START RDR command must be issued for the magnetic 
tape drive or direct -access storage device designated by the SYSUT2 DD statement. 

For additional information on the IEBEDIT utility program, refer to OS/VS Utilities. 

Figure 25 shows an IEBEDIT input deck for restarting Stage II, jobs 11,12, and 13 from tape. 
In this example, space allocation for SYS1 .LINKLIB was not sufficient, causing the subsequent 
job steps to fail. Since job 1 1 included link-edits with output to SYS1 .LPALIB and 
SYS 1 .LINKLIB that did not execute, they need to be restarted. Also, although job 12 
executed, it needs to be restarted to obtain accurate results. The restart job stream consists of 
job 1 1 , steps 4 through 24, and job 1 2 (IEHLIST). 



PGM=IEBEDIT 

SYSOUT=A 

UNIT=2 4 , LABEL= ( , NL) , DSN=STAGEl , X 

VOL=SER=JOBSTM, X 

DCB=(RECFM=F,BLKSIZE=80,DEN=2) , X 

DISP= (OLD, KEEP) 

UNIT=2400 ,DISP= ( ,KEEP) , X 

VOL=SER=001234,DSN=OUTTAPE, X 

LABEL=(,NL) , X 

DCB= (RECFM=F , BLKSIZE=80 ,DEN=2) 
* 

START=SYSGEN11,TYPE=EXCLUDE, X 
STEPNAME= (SGI , SG2 , SG3 ) 
START=SYSGEN12 



//RESTART 


JOB 


// 


EXEC 


//SYSPRINT 


DD 


//SYSUT1 


DD 


// 




// 




// 




//SYSUT2 


DD 


// 




// 




// 




//SYSIN 


DD 


EDIT 




EDIT 




/* 





Figure 25 . Restarting Stage II from tape 



Guidelines for Restarting Stage II 



The following section gives guidelines for restarting Stage II. Restarting may require the 
scratching and reallocation of space for the system data sets. When this is necessary, refer to 
the section, "Reallocating Space for Data Sets" for the procedure to be followed. After the 
necessary corrections have been made, the actual restarting of Stage II can be accomplished by 
one of the methods described in "Restart Techniques." 

If the problem encountered is other than space allocation, such as component failures or 
machine malfunctions, you should follow the instructions printed out in the error messages 
or error codes and then refer to OS/VS Message Library: VS2 System Messages or OS/VS 
Message Library: System Codes. 

Restarting Job 1 : IEHPROGM. Restart the entire job 

Restarting Job 2: Assemblies. To restart any assembly step, place the JOB card in front of 
the EXEC card for that assembly, or use the IEBEDIT program if the job stream is on tape 
or disk. 
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Restarting Job 3 : IEBCOPY. To restart , space for SYS 1 . MACLIB , SYS 1 .PROCLIB , 
SYS1.PARMLIB, and SYS1.SAMPLIB must be reallocated if space allocation was the problem. 
If this was a TSO-generation, space for SYS 1. HELP and SYS1.UADS must also be reallocated. 
Scratch the space for the data sets on their original volume using the IEHPROGM utility 
program. Reallocate the space, increasing the amount, for the data sets on their original 
volume. Then restart Stage II at the beginning of the job. 

Restarting Job 4. IEHPROGM, IFCDIPOO. To restart, place the JOB card in front of the job 
step that failed, or use the IEBEDIT utility program if the job stream is on tape or disk. 

Restarting Jobs 5,6, and 7: IEBCOPY. If the problem was not enough space, you can carry 
out one of these procedures: 

. Copy the system data set to a scratch volume using the IEBCOPY utility program. 
Scratch the space for the system data set on its original volume using IEHPROGM. 
Reallocate the space, increasing the amount of space, for the system data set on its 
original volume. Use IEBCOPY to copy the system data set from the scratch volume to 
its original volume. Restart Stage II and the beginning of the job, or 

. Reallocate the system data sets affected and restart with the first job that performs 
copies to those system data sets. 

If the problem is not insufficient space, restart the job, as any members already copied will 
not be copied again. (See "Reallocating Space for Data Sets.") 

Restarting Job 8: IEBUPDTE. To restart, place the JOB card in front of the first EXEC 
statement to be reexecuted or use the IEBEDIT program if the job stream is on tape or disk. 

Restarting Job 9: Assemblies and Nucleus Link-Edit. To restart any assembly step, place the 
JOB card in front of the EXEC card for that assembly or use the IEBEDIT program if the job 
stream is on tape or disk. All assemblies must execute successfully before the link-edit step 
will start. If space allocation was the problem: 

Scratch SYS 1 . NUCLEUS and reallocate space for it 

• Execute Job 7 (IEBCOPY) to copy modules from the distribution library to 
SYS 1. NUCLEUS 

• Execute the nucleus link-edit job step 

Restarting Job 10: Assemblies. To restart, place the JOB card in front of the EXEC card of 
the step that failed or use the IEBEDIT utility program if the job stream is on tape or disk. 

Restarting Job 1 1 : Assemblies and Link-Edits. To restart any assembly step, place the JOB 
card in front of the EXEC card for that assembly or use the IEBEDIT program if the job stream 
is on tape or disk. All assemblies must execute successfully before the link-edit steps will start. 
To restart a link-edit step: 

. If the problem is not enough space for the system data set, scratch any members that 
were added by the failing step. Copy the system data set to a scratch volume using the 
IEBCOPY utility program. Scratch the system data set from its original volume. 
Reallocate space for the data set and copy the data set from the scratch volume. Place 
the JOB card in front of the EXEC card of the job step that failed or use the IEBEDIT 
program if the job stream is on tape or disk. 

. If the problem is not one of space, place the JOB card in front of the EXEC card of the 
job step that failed or use the IEBEDIT program if the job stream is on tape or disk. 

I Restarting Job 12: IQADCMOO. Restart the entire job. 
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I Restarting Job 13: IEHPROGM, IEHLIST. If this job step executed before all previous job 

steps have executed successfully and you specified an index value in the GENERATE macro 
instruction, you must rename the index of the system data sets to the value specified in the 
INDEX parameter of the GENERATE macro instruction. Then reexecute the jobs that failed 

I and rerun job 13. 

Reallocating Space for Data Sets 

The following sections discuss the reallocation of space for the utility data set, OBJPDS, and 
the reallocation of space for the system data sets. 

Reallocating space for data sets includes: 

• Scratching the space that was originally allocated to the data set 

. Allocating new space to the data set 

. Possible recataloging if you are switching volumes 

The reallocations described in this section may alter the sequence of the new system data sets 
on a volume. If their sequence is important, the IEBCOPY utility program can be used after 
system generation to rearrange the new system data sets. 

Reallocating Space for the OBJPDS Utility Data Set 

Figure 26 shows the statements used to reallocate space for the utility data set OBJPDS — 
space that was originally allocated for Stage II of system generation. (See "Stage II Input" in 
the chapter "System Control Program Installation".) When scratching the data set, the 
DSNAME that is specified in the first DD statement must be the DSNAME that was specified 
for that data set in the original allocation. 

//OBJPDS JOB 

//STEP1 EXEC PGM=IEHPROGM SCRATCH OBJPDS 

//OBJPDS DD DSNAME=SYS1 . name ,DISP= (OLD , DELETE) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD DUMMY 

//STEP 2 EXEC PGM=IEHPROGM REALLOCATE OBJPDS 

//OBJPDS DD DSNAME=dsname, SPACE= (space) , X 

| // DISP=(,KEEP) ,UNIT=unit address, X 

// VOLUME=(, RETAIN, SER=volume serial) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD DUMMY 

/* 

// 

Figure 26. Reallocating space for the OBJPDS utility data set 



Reallocating Space for System Data Sets 

The method for reallocating space for a system data set depends on whether the data set 
contains data that must be saved. If the data set does not contain data, the IEHPROGM 
utility program can be used to scratch and reallocate the system data set. If the system data 
set contains data that must be saved, the data will have to be copied into a temporary data set, 
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the original data set will have to be reallocated, and the contents of the data set copied from 
the temporary data set into the reallocated data set. 

The input deck for scratching and reallocating system data sets must contain the following 
statements in the order shown: 

• A JOB statement with any parameters required by your installation. 
An EXEC statement with the PGM=IEHPROGM parameter. 

• A SYSPRINT DD statement defining the system output unit. 

• A DD statement defining the unit address and serial number of the generating system's 
system residence volume : 

//SYSRES DD UNIT=unit,VOLUME=SER=serial,DISP=OLD 

• A DD statement defining any other permanent volume on which the system data sets 
to be reallocated reside: 

//OTHERVOL DD UNIT=unit,VOLUME=SER=serial,DISP=OLD 

. A DD statement for each type of removable volume on which the system data sets to 
be reallocated reside: 

//DDNAME DD UNIT=(unit„ DEFER), VOLUME=PRIVATE,DISP=OLD 

A DD * statement (SYSIN). 

• A SCRATCH statement for each new system data set to be reallocated. The SCRATCH 
statement must have the following format : 

SCRATCH DSNAME=dsname,VOL=device=serial,PURGE 

• A /* statement. 

An EXEC statement with the PGM=IEHPROGM parameter. 

• A DD statement defining the unit address and serial number of the generating system's 
system residence volume (example shown above). 

• A DD statement for each permanent volume on which the system data sets to be 
reallocated reside (example shown above). 

. A DD statement for each type of removable volume on which the system data sets to 
be reallocated reside (example shown above). 

. A SYSPRINT DD statement defining the system output unit. 

• A DD statement for each of the system data sets to be reallocated: 

//ddname DD DSNAME=dsname,VOLUME=(,RETAIN,SER=serial), X 

// UNIT=unit,LABEL=EXPDT=99350,SPACE=(allocation), X 

// DISP=(,KEEP),DCB=(parameters) 

A DD * statement (SYSIN). 

• A /* statement. 
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As an example of the reallocation of system data sets that do not contain meaningful data, 
suppose SYS1 .LPALIB and SYS1 .LINKLIB must be reallocated. The original allocation for 
these two data sets was: 



//LPALIB 

// 

// 

// 

//LINKLIB 

// 
// 



DD 



DD 



DSNAME=SYS1. LPALIB, VOLUME=(, RETAIN, SER=AAAlll) , X 

UNIT=3330,DISP=(,KEEP) ,SPACE=(CYL, (15,1,187) ) , X 

LABEL=EXPDT=99350, X 

DCB= (DSORG=POU,RECFM=U,BLKSIZE=1024) 

DSNAME=SYS1. LINKLIB, VOLUME=(, RETAIN, SER=AAA112) , X 

UNIT=3330,DISP=(,KEEP) ,SPACE=(CYL, (15,5,100) ) , X 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=13030) 



The generating system residence volume is a 3330 volume. Figure 27 shows the input deck 
for this reallocation: 



//SAME JOB 
//STEPl EXEC 
//NEWRES DD 
//LINVOL DD 
//SYSPRINT DD 
//SYSIN DD 
SCRATCH 
SCRATCH 

/* 

//STEP 2 EXEC 

//NEWRES DD 

//LINVOL DD 

//SYSPRINT DD 

//LPALIB DD 

// 

//■ 

// 

//LINKLIB DD 

// 
// 
//SYSIN DD 

/* 

// 



PGM=IEHPROGM SCRATCH 

UNIT=3330,VOLUME=SER=AAAlll,DISP=OLD 

UNIT=3330,VOLUME=(,RETAIN,SER=AAA112) ,DISP=OLD 

SYSOUT=A 
* 

DSNAME=SYS1. LPALIB, VOL=3330=AAA111, PURGE 
DSNAME=SYS1. LINKLIB, VOL=3330=AAA112, PURGE 

PGM=IEHPROGM ALLOCATE 

UNIT=3330,VOLUME=SER=AAA111,DISP=OLD 

UNIT=(3330, , DEFER) , VOLUME =PRIVATE ,DISP=OLD 

SYSOUT=A 

DSNAME=SYS1 . LPALIB ,VOLUME= ( , RETAIN , SER=AAAlll) , 

UNIT=3330,DISP=(,KEEP) ,SPACE=(CYL, (20,5,75) ) , 

LABEL=EXPDT= 99350, 

DCB=(RECFM=U,BLKSIZE=1024,DSORG=POU) 

DSNAME=SYS1 . LINKLIB , VOLUME = ( , RETAIN , SER=AAAll2) , 

UNIT=3330,DISP=(,KEEP) ,SPACE=(CYL, (50,10, 150) ) , 

LABEL=EXPDT=99350,DCB=(RECFM=U,BLKSIZE=13030) 

DUMMY 



X 
X 
X 

X 
X 



Figure 27. Reallocating SYS1. LPALIB and SYS1. LINKLIB 



If the system data set to be reallocated contains data, one of two procedures can be followed 
if there is enough space on the volume for a new allocation: 

• Rename the system data set 

• Allocate space for the system data set (with its correct name) on the same volume using 
the IEHPROGM utility program 
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. Copy the data in the renamed data set onto the newly allocated system data set using 
the IEBCOPY utility program 

• Scratch the renamed data set using the IEHPROGM utility program 

Figure 28 illustrates reallocation of a data set on the same volume. The system data set to be 
reallocated is SYS1.PARMLIB. It was allocated space during the preparation for system 
generation with the following IEHPROGM DD statement: 

//PARMLIB DD DSNAME=SYS1 . PARML IB, VOLUME = (, RETAIN , SER=SYSTEM) , X 

// UNIT=2314,DISP=(,KEEP) , X 

// SPACE=(TRK, (7,1,3) , ,CONTIG) ,LABEL=EXPDT=99350 , X 

// DCB=(RECFM=F,BLKSIZE=80) 

The new system residence volume is a 2314 volume whose serial number is SYSTEM. The 
renamed SYS1 .PARMLIB will be called SYS1 .TEMPPARM. 



//MOVE JOB 
//STEP1 EXEC 
//SYSPRINT DD 
//NEWRES DD 
//SYSIN DD 
RENAME 

/* 

//STEP 2 EXEC 

//SYSPRINT DD 

//PARMLIB DD 

// 

// 

// 

// 

// 

//SYSIN DD 

/* 

//STEP 3 EXEC 

//SYSPRINT DD 
//SYSUT1 DD 

// 

//SYSUT2 DD 
//SYSIN DD 
COPY 

/* 

//STEP4 EXEC 

//SYSPRINT DD 
//SYSIN DD 
SCRATCH 

/* 



PGM=IEHPROGM RENAME 

SYSOUT=A 

UNIT=2314,VOLUME=SER=SYSTEM,DISP=OLD 
* 

DSNAME=SYS1. PARMLIB, VOL=2 3 14=SYSTEM, X 
NEWNAME=SYS1 . TEMPPARM 



PGM=IEHPROGM 
SYSOUT=A 

DSNAME=SYS1 . PARMLIB , 
VOLUME= ( , RETAIN , SER=SYSTEM) , 
UNIT=2314,DISP=(,KEEP) , 
SPACE= (TRK, (8 , , 3) , ,CONTIG) , 
LABEL=EXPDT= 9 9350, 
DCB=(RECFM=F,BLKSIZE=80) 
DUMMY 



REALLOCATE 



X 
X 
X 
X 
X 



PGM=IEBCOPY COPY 

SYSOUT=A 

DSNAME=S YS1. TEMPPARM, D I SP=OLD , 

UNIT=2314 ,VOL=SER=SYSTEM 

DSNAME=SYS1. PARMLIB, DISP=OLD 

* 

INDD=SYSUT1 ,OUTDD=SYSUT2 

PGM=IEHPROGM SCRATCH 

SYSOUT=A 
* 

DSNAME=SYS1. TEMPPARM, VOL=2 3 14=SYSTEM 



X 



Figure 28. Reallocating SYS 1. PARMLIB 
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If there is not enough room on the volume for a temporary data set: 

• Use the IEBCOPY utility program to copy the data set onto another volume. 

. Scratch the data set from the original volume and reallocate the space for the data set on 
the original volume. 

. Use IEBCOPY to copy the contents of the data set from the other volume to the original 
volume. 



174 OS/VS2 System Generation Reference 



TESTING THE SYSTEM CONTROL PROGRAM 

This chapter discusses the installation verification procedure. Included in this chapter are: 

• A definition of the installation verification procedure 

• A discussion of the installation verification procedure 

. The system configuration required to use the installation verification procedure 

. The procedures for using the installation verification procedure. 

The Installation Verification Procedure (IVP) 

The installation verification procedure (IVP) is a program that tests whether the newly 
installed VS2 System Control Program is operational. It also tests whether the newly created 
System Control Program supports your machine configuration. 

The jobs in IVP test only the System Control Program. IVP does not test any Program 
Products, programs with service classification "C," or similar programs added after the new 
system control program has been generated. Any program of this type for which verification 
or demonstration is required should be tested by its own testing procedure or sample program. 

IVP Minimum Configuration 

The IVP job stream will execute with all machine configurations and requires only the minimum 
VS2 configuration. 

The IVP Job Stream 

The IVP job stream is contained in your new VS2 system in the partitioned data set 
SYS1.SAMPLIB. Its member name is IVPJOBS. The IVP job stream consists of jobs that: 

• Provide device information, such as unit address, device type, device status, volume 
serial number, volume state, ordered output, and device bypass. 

. Execute an assemble/link-edit/go to test the basic functions of the newly installed 

System Control Program. 

Provide a listing of SYS1 .PARMLIB. 

• Force an 806 ABEND and the resulting dump (see OS/VS Message Library: VS2 
System Codes). 



Procedures for Using IVP 



To verify that your new System Control Program is correctly installed, carry out the following 
steps: 

, Upon successful completion of Stage II (no unaccounted for errors are indicated in the 

Stage II listings), carry out the IPL procedure. 

Issue a START RDR command to the IVP job stream (IVPJOBS) 
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• To issue a START RDR command to the IVP job stream, type the following command: 

START RDR.R, 132,VOL=SER=SYSRES,LABEL=(,SL), 
DSNAME=SYS 1 . S AMPLIB (IVPJOBS) 

. If 132 and SYSRES are not the unit address and volume serial number of the system 
residence volume, enter the correct information. 

• Review the I/O device information produced by the job stream to verify the machine 
configuration. 

• Review the listing of SYS 1 .PARMLIB for completeness. 
. Review the results of the assemble/link-edit/go for errors. 

• Verify that an 806 ABEND occurred and that a dump was provided. 

• Save the IVP output for future reference. 

The completion of the above steps and normal end-of-job (EOJ) of the IVP job stream (exclud- 
ing the 806 ABEND) constitutes successful verification of your new VS2 system. 
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EXAMPLES OF SYSTEM GENERATION 



This chapter contains examples of system generation. Included in this chapter are: 

. A diagram of the system to be generated 

. The system generation macro instructions for a complete system generation 

. The system generation macro instructions for a nucleus generation 

• The system generation macro instructions for an I/O device generation 



Machine Configuration 



Figure 29 shows the machine configuration for the system to be generated using the macro 
instructions shown in Figure 30. The CPU is a System/370 Model 145. 



3210 

Console 



009 



Multiplexor 
Channel 



2520 
Model B1 

Reader . 

Punch 00C 



3211 
Printer 



00E 




Figure 29. Machine Configuration 
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System Generation Macro Instructions for a Complete System Generation 

Figure 30 shows the system generation macro instructions for a complete system generation. 

The new system will support the devices shown in Figure 29. The following options have been 
specified: 

User-assigned checkpoint/restart codes 

The size of the area of virtual storage that is to contain the linkage editor 

The options for the loader 

Exclusion of BTAM 

Exclusion of GPS.TCAM, OCR, and TSO macro definitions from SYS1 .MACLIB 

The size of the page data sets 

Inclusion of 1403 UCS images 

The unitname SYSSQ for magnetic tape 

The unitname SYSDA for direct-access devices 

A user-library SYS 1. USER that contains modules to be placed in the nucleus and 
SYS 1 . LPALIB during system generation 

A user-library SYS1 .LINK that contains modules to be placed in SYS1.LINKLIB during 
system generation. 

/—Col. 10 

CENPROCS MODEL=145R 

CTRLPROG QSPACE=1,TZ=(E,5,5) ,REAL=16 ,TRACE=100 , X 

ASCII=INCLUDE / OPTIONS=(DEVSTAT) ,MAXIO=50, X 

DEBTS ZE=8 , DEBTINC=8 
CHANNEL ADDRESS=0 ,TYPE=MULT I PLEXOR 
CHANNEL ADDRESS=(1,2) ,TYPE=SELECTOR 
IODEVICE UNIT=3210,ADDRESS=009 
IODEVICE UNIT=2520,MODEL=Bl,ADDRESS=(00C) 
IODEVICE UNIT=3211,ADDRESS=00E 
IODEVICE UNIT=2401,ADDRESS= (180,2) ,M0DEL=1, X 

FEATURE=9 -TRACK 
IODEVICE UNIT=2314,ADDRESS=(130) ,OPTCHAN=2 
CKPTREST NOTELIG=(001,031) ,ELIGBLE= (100) 
DATAMGT ACSMETH= (BTAM) 
EDITOR SIZE= (256,64) 
LOADER LIN=SYSLIN,LIB=SYSLIB,PRINT=SYSLOUT, X 

SIZE=164,PARM= (MAP, LET, CALL, RES) 
MACLIB EXCLUDE=(GPS,TCAM,OCR,TSO) 
GRAPHICS PORRTNS=INCLUDE , GSP=EXCLUDE 
PAGE TYPE=P , S I ZE= ( BLK ,10), LPA=YES 
PAGE UNIT=130 
SCHEDULR CONSOLE=009,ALTCONS=(I-00C,O-00E) , X 

START I=MANUAL,REPLY=10, X 

HARDCPY=(SYSLOG,ALL,INCMDS) ,BCLMT=100, X 

VLMOUNT=AVR , TAVR=2 , WTLCLSS=D , ESV=CON , X 

IOC=009 
SECONSLE CONSOLE=(I-00C, O-00E) ,ALTCONS=009 

Figure 30 (Part 1 of 2). System generation macro instructions for a complete system generation 
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LPALIB PDS=SYS1.USER,MEMBERS= (IGC0025E) 

SVCTABLE SVC-250-Dl-FC01,SVC-255-E3-FC00 

RESMODS PDS=SYS1.USER,MEMBERS=(RES1,RES2,IGC250) 

LINKLIB PDS=SYSl.LINK,MEMBERS=(Ul,U2) 

UCS IMAGE=ALL1403,DEFAULT=(AN,HN) 

UNITNAME NAME=SYSDA, X 

UNIT= (130 ,131,132,133 ,134,135, 136 ,137) 
UNITNAME NAME=SYSSQ,UNIT= (180,181) 
GENERATE GENTYPE=ALL 
END 

Figure 30 (Part 2 of 2). System generation macro instructions for a complete system generation 

System Generation Macro Instructions for a Nucleus Generation 

Figure 31 shows the macro instructions to add a new nucleus to the system that was generated 
using the macros shown in Figure 30. 

For a nucleus generation, the CENPROCS, CHANNEL, and IODEVICE macros must be respec- 
ified exactly as they were for the last complete system generation. The SCHEDULR parameters 
must also be respecified. DEVSTAT support and the system trace table will be excluded 
from the system (CTRLPROG). The DEB table and the number of extents will be altered 
from what was originally specified in the CTRLPROG macro to the default values. An addi- 
tional page data set is to be included and additional user-written routines are to be added to 
the nucleus and SYS1 .LINKLIB. 

/-Col. 10 

CENPROCS MODEL=145R 

CTRLPROG QSPACE=1,TZ=(E,5,5) ,REAL=16, X 

TRACE=0 ,ASCII=INCLUDE 

CHANNEL ADDRESS=0 ,TYPE=MULTIPLEXOR 

CHANNEL ADDRESS=(1,2) ,TYPE=SELECTOR 

IODEVICE UNIT=3210,ADDRESS=009 

IODEVICE UNIT=2520,MODEL=Bl,ADDRESS=(00C) 

IODEVICE UNIT=3211,ADDRESS=00E 

IODEVICE UNIT=2401,ADDRESS= (180,2) ,MODEL=l, X 
FEATURE=9-TRACK • 

IODEVICE UNIT=2314,ADDRESS=(130) ,OPTCHAN=2 

DATAMGT ACSMETH= (BTAM) 

GRAPHICS PORRTNS=INCLUDE,GSP=EXCLUDE 

PAGE TYPE=P,SIZE=(BLK,10) ,LPA=YES 

PAGE UNIT=130 

PAGE UNIT=131 ADD PAGE ON 131 

SCHEDULR CONSOLE=009,ALTCONS=(I-00C,O-00E) , X 
START I=MANUAL,REPLY=10, X 

HARDCPY=(SYSLOG,ALL,INCMDS) ,BCLMT=100, X 
VLMOUNT=AVR,TAVR=200,WTLCLSS=D,ESV=CON, X 
IOC=009 

SECONSLE CONSOLE=(I-00C,O-00E) ,ALTCONS=009 

LPALIB PDS=SYS1.USER,MEMBERS=(IGC0025E) 

Figure 3 1 (Part 1 of 2). System gener ation macro instructions for a nucleus generation 
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SVCTABLE SVC-250-Dl-FC01,SVC-255-E3-FC00 

RESMODS PDS=SYS1.USER,MEMBERS=(RES1,RES2,RES3,IGC250) 

LINKLIB PDS=SYS1.LINK, X 

MEMBERS=(Ul,U2,U3) ADD MEMBER U3 
UNITNAME NAME=SYSSQ,UNIT= (18 0,181, (130,8) ) 
UNITNAME NAME=SYSDA , UNIT= ((130,8)) 
GENERATE GENTYPE= (NUCLEUS ,1) 
END 

Figure 31 (Part 2 of 2). System generation macro instructions for a nucleus generation 

System Generation Macro Instructions for an I/O Device Generation 

Figure 32 shows the macro instructions to add additional I/O devices and channels to the system 
that was generated using the macros shown in Figure 30. 

In this example, a 3330 at addresses 150-155 and a 3420 at addresses 280 and 281 are to be 
added to the system configuration, and channel 3 is to be made available to the system. The 
unitname specifications were changed so that SYSSQ will be the unitname for all of the 
sequential and direct-access devices. The number of simultaneous I/O operations that can 
occur has been increased to 100. 

i— Col. 10 

CENPROCS MODEL=145R 

CTRLPROG QSPACE=1,TZ=(E,5,5) ,REAL=16,TRACE=100, X 

ASCII=INCLUDE,OPTIONS=(DEVSTAT) ,MAXIO=100, X 

DEBTSZE=80 ,DEBTINC=80 
CHANNEL ADDRESS=0 ,TYPE=MULTIPLEXOR 
CHANNEL ADDRESS=(1,2) ,TYPE=SELECTOR 
CHANNEL ADDRESS=3,TYPE=BLKMPXR 
IODEVICE UNIT=3210,ADDRESS=009 
IODEVICE UNIT=2520,MODEL=Bl,ADDRESS=(00C) 
IODEVICE UNIT=3211,ADDRESS=00E 
IODEVICE UNIT=2401,ADDRESS= (180,2) ,MODEL=l, X 

FEATURE=9-TRACK 
IODEVICE UNIT=2314,ADDRESS=(130) ,OPTCHAN=2 
IODEVICE UNIT=333"0,ADDRESS= (150,6) ,FEATURE= SHARED , X 

OPTCHAN=(2,3) 
IODEVICE UNIT=3420,ADDRESS= (280,2) ,MODEL=5, X 

FEATURE= ( 9 -TRACK , SHARABLE ) , OPTCHAN= 3 
IODEVICE UNIT=1287,ADDRESS=00A 
CKPTREST NOTELIG= (001,031) ,ELIGBLE= (100) 
DATAMGT ACSMETH= (BTAM) 
GRAPHICS PORRTNS=INCLUDE,GSP=EXCLUDE 
PAGE TYPE=P,SIZE=(BLK,10) ,LPA=YES 
PAGE UNIT=130 

Figure 32 (Part 1 of 2). System generation macro instructions for an I/O device generation 
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SCHEDULR CONSOLE=009,ALTCONS=(I-00C,O-00E) , X 

START I=MANUAL , REPLY=10 , X 

HARDCPY=(SYSLOG,ALL,INCMDS) ,BCLMT=100, X 

VLMOUNT=AVR,TAVR=200 , WTLCLSS=D ,ESV=CON , IOC=009 
SECONSLE CONSOLE=(I-00C,O-00E) ,ALTCONS=009 
LPALIB PDS=SYSl.USER,MEMBERS=(IGC0025E) 
SVCTABLE SVC-250-Dl-FC01,SVC-255-E3-FC00 
RESMODS PDS=SYSl.USER,MEMBERS=(RESl,RES2 r IGC250) 
LINKLIB PDS=SYSl.LINK,MEMBERS=(Ul,U2) 
UCS IMAGE=ALL1403,DEFAULT=(AN,HN) 
UNITNAME NAME=SYSDA,UNIT=( (130,7) , (150,6) ) 
UNITNAME NAME=SYSSQ, X 

UNIT=(180,181,280,281, (130,8) , (150,6)) 
GENERATE GENTYPE= (10, 1) 

Figure 32 (Part 2 of 2). System generation macro instructions for an I/O device generation 
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APPENDIX A: DEVICE TYPES 



A device type is automatically assigned during system generation to each collection of devices 
for which a type of device is specified by the UNIT parameter of an IODEVICE macro instruc- 
tion. The names and devices to which they apply follow. 

Device Type Description 

Magnetic Tape Devices 

2400 2400 9-track magnetic tape drive having an 800 bits-per-inch (density) 

capability when the dual-density feature is not installed or an 800 and 
1600 bits-per-inch (density) capability when the dual-density feature 
is installed 

2400-1 2400 magnetic tape drive with 7-track capability and without data 

conversion 

2400-2 2400 magnetic tape drive with 7-track capability and data conversion 

2400-3 2400 or 2420 9-track magnetic tape drive having only a 1600 bits-per- 

inch (density) capability 

24004 2400 9-track magnetic tape drive having an 800 and 1 600 bits-per-inch 

(density) capability 

2495 2495 tape cartridge reader 

3400-2 3420 magnetic tape drive having 7-track capability and data conversion 

3400-3 3410 or 3420 9-track magnetic tape drive having 1600 bits-per-inch 

(density) capability 

34004 3410 or 3420 9-track magnetic tape drive having 800 and 1600 bits- 

per-inch (density) capability 

Direct-Access Devices 

2305-1 2305 fixed-head disk storage (Model 1) 

2305-2 2305 fixed-head disk storage (Model 2) 

23 1 4/23 1 9 23 1 4/23 1 9 direct-access storage facility 

3330/3333 3330 disk storage drive/3333 disk storage and control 

Unit Record Equipment and other Devices 

1052 1052 printer keyboard (Model 7) 

1053 1053 printer (Model 4) 

1403 1403 printer or 1404 printer (continuous form only) 

1443 1443 printer (Model Nl) 

2501 2501 card reader 

2520 2520 card reader punch 

2540-1 2540 card reader punch (read feed) 

2540-2 2540 card reader punch (punch feed) 

2671 2671 paper tape reader 

3066 3066 system console - System/370 Model 165II 

3 1 58 3158 display console keyboard - System/370 Model 1 58 
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Device Type 


Description 




Unit Record Equipment and other Devices (continued) 


3210 


3210 console printer keyboard 


3211 


3211 printer 


3213 


3213 printer 


3215 


3215 console printer keyboard 


3505 


3505 card reader 


3525 


3525 card punch with read feature 




Graphics Devices 


2250-1 


2250 Model 1 display unit 


2250-3 


2250 Model 3 display unit 


2260-1 


2260 Model 1 display station (local attachment) 


2260-2 


2260 Model 2 display station (local attachment) 


2265 


2265 display station 


3277-1 


3277 Model 1 display station 


3277-2 


3277 Model 2 display station 


3284-1 


3284 Model 1 printer 


3284-2 


3284 Model 2 printer 


3286-1 


3286 Model 1 printer 


3286-2 


3286 Model 2 printer 




Optical Character Readers 


1275 


1275 optical reader sorter (available through World Trade branch 




offices only) 


1287 


1287 optical reader 


1288 


1288 optical reader 




Magnetic Character Reader 


1419 


1419 magnetic character reader 




Audio Response Unit 


7770 


7770 audio response unit 




Remote Analysis Unit 


2955 


2955 remote analysis unit 
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APPENDIX B: DESCRIPTION OF THE STARTER SYSTEM 
AND DISTRIBUTION LIBRARY TAPES 



The starter system and the distribution libraries are distributed on tapes provided by IBM or 
on tapes that you provide. 

The starter system is distributed in a dump/restore format for either a 2314/2319 or 3330 
Direct -Access Storage Device. 

The distribution libraries are unloaded partitioned data sets that are distributed in the 
IEBCOPY unload/load format on either one 9-track 1600 BPI tape or two 9-track 800 BPI 
tapes. 

| There are 40 files on the distribution library tape. The first file contains the control statements 
for the IEBCOPY utility program that are used for copying the distribution libraries from tape 

| to disk. Each of the remaining 39 files contains a distribution library. Figure 33 lists the 
distribution libraries that are on the distribution library tape. 

The starter system and the distribution libraries must be on direct-access volumes for Stage I 
and Stage II. See "Preparation for System Generation" for the procedures for initializing the 
direct-access volumes for the starter system and distribution libraries, dumping the starter 
system to a direct-access volume, and copying the distribution libraries to a direct-access 
volume. 



IEBCOPY (file 1) 

SYS1.AOS00 

SYS1.AOS03 

SYS1.AOS04 

SYS1.AOS05 

SYS1.AOS06 

SYS1.AOS07 

SYS1.AOS10 

SYS1.AOS11 

SYS1.AOS12 

SYS1.AOS20 

SYS1.AOS21 

SYS1.AOSB0 

SYS1.AOSB3 

SYS1.AOSC2 

SYS1.AOSC5 

SYS1.AOSC6 

SYS1.AOSCA 

SYS1.AOSCD 

SYS1.AOSCE 



SYS1 
SYS1 
SYS1 
SYS1 
SYS1 
SYS1 
SYS1 
SYS1, 
SYS1 
SYS1, 
SYS1. 
SYS1. 
SYS1. 
SYS1. 
SYSL 
SYSL 
SYSL 
SYSl. 
SYSL 
SYSl. 



AOSD0 

AOSD7 

AOSD8 

AOSG0 

AOST3 

AOST4 

AOSU0 

ACMDLIB 

AGENLIB 

AHELP 

ALPALIB 

AMACLIB 

AMODGEN 

APARMLIB 

APROCLIB 

ASAMPLIB 

ATCAMMAC 

ATSOMAC 

AUADS 

AOSA0 (file 40) 



Figure 33. Tape distribution of the distribution libraries 
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APPENDIX C: SYSTEM GENERATION MESSAGES 



System generation messages are produced by the assembler program during the expansion of 
system generation macro instructions. These messages are printed in the assembler listing in 
the SYSPRINT data set. Messages of three types are produced: error messages, warning 
messages, and informative messages. 



Error Messages 



Figure 34 shows the message code and format of system generation error messages. The 
messages follow. 



IEIaaannn text 

Explanation: The error indicated by the message text is a coding error in the system generation 
macro instruction aaa that you coded. The message serial number nnn identifies the message. 

For the CHANNEL and IODEVICE macro instructions, the message text begins with either the 
name field of the macro instruction or, if the name field was omitted, the sequential identifica- 
tion number provided by the system. 

Examples of error messages are: 

5, * * * IEICEN100 MODEL VALUE NOT SPECIFIED 

5, * * * IEICHA102 CHANNEL 2 -ADDRESS VALUE NOT SPECIFIED 

5, * * * IEICHA102 CHAN#2 ADDRESS VALUE NOT SPECIFIED 

The first example illustrates a message for the CENPROCS macro instruction. 

The second example illustrates a message for a CHANNEL macro instruction. "CHANNEL 2" 
is the name field of the macro instruction. The third example illustrates the same message, but 
in this case the name field of the macro instruction was omitted and "CHAN#2" was supplied 
by the macro instruction. 

System Action: The assembler program did not produce a job stream in the SYSPUNCH data 
set. The program analyzed all remaining system generation macro instructions and printed any 
other required messages. Either message IEIGEN1 1 3 or IEIGEN1 1 6 was printed, followed by 
the message GENERATION TERMINATED. Then the system generation process was abnor- 
mally terminated. 

Severity Code: 5 

User Response: Correct the error or errors indicated and begin the system generation process 
from the start of Stage I. 

IEIGEN113 QUIT SWITCH PRIOR TO GENERATE MACRO 

Explanation: One or more errors, indicated by messages, were detected before the GENERATE 
macro instruction was expanded. 



Appendix C: System Generation Messages 187 



Severity Code: 7 

User Response: Correct the error or errors indicated and begin the system generation process 
from the start of Stage I. 



IEIGEN116 QUIT SWITCH SET IN GENERATE MACRO 

Explanation: One or more errors were detected during the expansion of the GENERATE 
macro instruction. 

Severity Code: 7 

User Response: Correct the error or errors indicated and begin the system generation process 
from the start of Stage I. 

7, * * * GENERATION TERMINATED * * * 

Explanation: The system generation process was abnormally terminated. 

Severity Code: 7 

User Response: None. This message follows message IEIGEN1 13 and/or IEIGEN1 16. 



Warning Messages 



Figure 34 shows the message code and format of system generation warning messages. The 
messages follow. 



IEIaaannn text 



Explanation: The message text indicates a condition in macro instruction aaa that may cause 
errors in the new system. The message serial number nnn identifies the message. For example: 

0, * * * IEIGEN940 EDITOR MACRO DEFAULTED 

Explanation: The EDITOR macro instruction was not specified and the default options were 
taken. 

Severity Code: 

User Response: None. 



0, * * * IEIGEN942 LPA=YES NOT SPECIFIED ON ANY PAGE MACRO — 
DEFAULTED TO FIRST PAGE MACRO 

Explanation: A device was not specified in a PAGE macro to contain the pageable link pack 
area. 

Severity Code: 

User Response: None 
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Informative Messages 



message text 



Explanation: This type of message documents the options selected for the new system through 
the system generation macro instructions. All options are described, whether the selection 
was explicit or implicit. 



***macro name*** component name*** component id*** 

Explanation: A message of this type appears before any PUNCH statements that were pro- 
duced by the macro expansion. The macro name is the name of the macro instruction that 
produced any succeeding PUNCH statements. The component name is the name of the com- 
ponent group responsbile for maintaining the particular macro expansion. The component ID 
is the identification to be used in reporting trouble if a problem is isolated to the code 
produced by the particular macro expansion. 



Message 


Code 


Code 




IEI 


s,* * * lEIaaannntext 




s = Severity code: 




Warning message; the condition indicated may cause errors 




in the new system. 




5 Error message; user error in coding of a system generation 




macro instruction. 




7 Error message; message is produced by the GENERATE 




macro instruction. 




aaa = An abreviation of the system generation macro instruction 




at which the error was detected: 




aaa Macro Instruction 




CEN CENPROCS 




CHA CHANNEL 




CKP CKPTREST 




CTR CTRLPROG 




DAT DATAMGT 




DTS DATASET 




EDI EDIT 




EDT EDITOR 




GEN GENERATE 




GPH GRAPHICS 




IOD IODEVICE 




LDR LOADER 




LNK LINKLIB 



Figure 34 (Part 1 of 2). System generation error and warning messages 
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Message 


Code 


Code 






aaa Macro Instruction 




LPA LPALIB 




MAL MACLIB 




PAG PAGE 




RES RESMODS 




SCH SCHEDULR 




SCN SECONSLE 




SVC SVCTABLE 




TSO TSO 




UCS UCS 




UNI UNITNAME 




nnn = Message serial number 




text = Message text j 



Figure 34 (Part 2 of 2). System generation error and warning messages 



190 OS/VS2 System Generation Reference 



APPENDIX D: FUNCTIONALLY EQUIVALENT I/O DEVICES 



I/O Device Equivalent to Usage 

2319 2314 The 2319 is a three-drive disk storage unit that attaches 

to any System/370. The 2319 drives are functionally 
equivalent to the 2314 drives. As with the 2314, a 
maximum of eight drives can be used. To use a 2319, 
specify UNIT =23 1 4 in an IODEVICE macro . 

A 2319 can be specified as the unitname of the device. 
To refer to a 2319 as a 2319, specify UNIT=2314 in an 
IODEVICE macro and NAME=2319 in a UNITNAME 
macro. 

3333 3330 The IBM 3333 Disk Storage and Control is functionally 

equivalent to the IBM 3330 Disk Storage Drive. To use 
a 3333, specify UNIT=3330 in an IODEVICE macro. 

A 3333 can be specified as the unitname of the device. 
To refer to a 3333 as a 3333, specify UNIT=3330 in an 
IODEVICE macro and NAME=3333 in a UNITNAME 
macro. 
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APPENDIX E: DIAGNOSTIC OVERRIDE 



Diagnostic override enables a job stream to be produced during Stage I, even though errors were 
found in the Stage I input deck. The job stream that is produced may or may not be meaning- 
ful, depending on the type of error. 

If you want diagnostic override, include the following statements in the Stage I input deck 
after the Stage I job control language statements: 

COPY SGSYSPAK 
&SGMENTB(16) SETB 1 
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APPENDIX F: CONSOLE SHEET OF THE PROCEDURES 
FOR STARTING THE STARTER SYSTEM 

This console sheet corresponds to the procedures for starting the starter system as described in 
"Preparing for System Generation." Text in uppercase indicates system commands and 
responses. Text in lowercase indicates the commands and responses that you must make. 

IEA101A SPECIFY SYSTEM PARAMETERS FOR RELEASE 01.0 VS/2 
IEA317A SYS1.PAGE ALLOCATED ON STARTR 
IEA332A SPECIFY DUMP OR CANCEL 



H 


CMDS 






ALL 


N 


ALL 


01 




1-2 


M 


ALL 


02 




1-2 


N 


INFO 


03 


Z,A 


NONE 


N 


INFO 


04 


Z,A 


NONE 


N 


INFO 


05 


Z,A 


NONE 


N 


INFO 


06 


Z,A 


NONE 


N 


INFO 


07 


Z,A 


NONE 


N 


INFO 


08 


Z,A 


NONE 


N 


INFO 


09 


Z,A' 


NONE 


N 


INFO 


10 


Z,A 


NONE 


N 


INFO 


11 


Z,A 


NONE 



IEE140I SYSLOG 
IEE140I OIF/009 
IEE140I 009/01F 
IEE140I 040/060 
IEE140I 060/0C0 
IEE140I 0C0/0D0 
IEE140I 0D0/0E0 
IEE140I 0E0/0F0 
IEE140I 0F0/140 
IEE140I 140/240 
IEE140I 240/340 
IEE140I 340/009 
IEE101A READY 
*IEE114A DATE=72 . 195 ,CLOCK=08 .10.48 

*00 IEE114A DATE=72.195,CLOCK=08.10.48,GMT REPLY WITH SET PARM OR U 
r 00, 'Q=(,F) ' 
IEE600I REPLY TO 00 IS;'Q=(,F)' 
IEE118I SET PARAMETER (S) ACCEPTED 
*01 IEF423A SPECIFY JOBQUE PARAMETERS 
r l,u 

IEE600I REPLY TO 01 IS;U 
mn jobnames,t 

*02 IEC107D E 23 5, STARTR, MASTER , SCHEDULR,SYS1 . SYSVLOGX 
IEE354I SMF PARAMETERS 
PRM=SYSSMF 
ALT=SYSSMF 
SID=H1 
OPI=YES 
JWT=010 
BUF=2000 
MDL=55 
MAN=ALL 
EXT=YES 
OPT=2 
*03 IEE357A REPLY WITH SMF VALUES OR U 
r 2,u 
IEE600I REPLY TO 02 IS;U 
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*04 IEC107D E 235,STARTR,MASTER,SCHEDULR,SYSl.SYSVLOGY 
r 3,u 

IEE600I REPLY TO 03 IS;U 

IEE363I SMF SYSSMF DEVICE NOT IN SYSTEM 
r 4,u 

IEE351I SMF SYS1.MAN RECORDING NOT BEING USED 

IEE600I REPLY TO 04 IS;U 

IEE041I LOG NOW RECORDING ON SYSl. SYSVLOGX ON 235 
s rdr,00c 

IEF403I RDR STARTED TIME=08 . 12 . 49 
s wtr,00E 

IEF403I WTR STARTED TIME=08 . 13 . 01 
s init 

IEF403I INIT STARTED TIME=08 . 13 . 12 
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GLOSSARY 



The following terms are defined as they are used in this book. If you do not find the term you are looking for, refer to 
the index or to the IBM Data Processing Glossary, GC20- 1699. 

IBM is grateful to the American National Standards Institute (ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for Information Processing, which was prepared by Subcommittee X3K5 on 
Terminology and Glossary of American National Standards Committee X3. ANSI definitions are preceded by an 
asterisk. 



ABEND: Abnormal end of task. 

AGENLIB: A distribution library that contains the 
macro definitions of the system generation macro 
instructions used during Stage I. 

AMODGEN: A distribution library that contains the 
macro definitions of the system generation macro 
instructions used during Stage II assemblies. 

assembler language: A source language that includes 
symbolic machine language statements in which there 
is a one-to-one correspondence with the instruction 
formats and data formats of the computer. 

automatic priority group: A group of tasks at a single 
priority level that are dispatched according to a 
special algorithm that attempts to provide optimum 
use of CPU and I/O resources by these tasks. 

binary synchronous transmission: Data transmission in 
which character synchronism is controlled by timing 
signals generated at the sending and receiving stations. 

BLDL table: A list of the track addresses of modules 
on SYS1.LINKLIB. The purpose of the table is to 
reduce the time required to find the listed modules 
onSYSl.LINKLIB. 

cataloged data set: A data set that is represented in an 
index or hierarchy of indexes in the system catalog; the 
indexes provide the means for locating the data set. 

cataloged procedure: A set of job control statements 
that has been placed in a partitioned data set called the 
procedure library and that can be retrieved by coding 
the name of the procedure on an execute (EXEC) state- 
ment or started by a START command. 

communications task: The part of job management 
responsible for handling communications between the 
operator console and the system. 

complete system generation: The creation of an entirely 
new System Control Program. 



console: That part of a computer used for communica- 
tion between the operator or maintenance engineer and 
the computer. 

control program: A program that is designed to schedule 
and supervise the performance of data processing work 
by a computing system. 

control unit: A device that controls the reading, writing, 
or display of data at one or more input/ output devices. 

CPU: Central processing unit. 

DAT: Dynamic address translation. 

data control block (DCB): A control block used by 
access routines in storing and retrieving data. 

data definition statement (DD): A job control statement 
that describes a data set associated with a particular job 
step. 

data mangement: A major function of the operating 
system that involves organizing, cataloging, locating, 
storing, retrieving, and maintaining data. 

data organization: The arrangement of information in a 
data set. For example, sequential organization or parti- 
tioned organization. 

data set: The major unit of data storage and retrieval in 
the operating system, consisting of a collection of data in 
one of several prescribed arrangements and described by 
control information to which the system has access. 

DCB: Data control block. 

DD statement: Data definition statement. 

ddname: Data definition name. 

device type: The general name for a kind of device; for 
example, 2314, 3330. See also group name, unit address. 

direct-access volume initialization: The use of the 
IBCDASDI or IEHDASDR utility programs for writing a 
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home address, a volume label, and a volume table of con- 
tents on a direct-access volume, for checking for defec- 
tive tracks and assigning alternate tracks for those that 
are defective, and for writing the IPL program on a new 
system volume. 

display unit: A device which provides a visual represen- 
tation of data. 

distribution libraries: IBM-supplied partitioned data sets 
on tape containing single VS2 components or combina- 
tions of VS2 components that the user restores to disk for 
subsequent inclusion in a new system. 

DSS: Dynamic Support System. 

dynamic address translation (DAT): The change of a 
virtual storage address to a real storage address during 
execution of an instruction. 

dynamic support system (DSS): An interactive debug- 
ging facility that allows authorized maintenance person- 
nel to monitor and analyze events and alter data. 

EOF: End of file. 

EOJ: End of job. 

EREP: The environment recording, editing, and printing 
of a program that makes the data contained on the sys- 
tem recorder file available for further analysis. 

ERP: Error recovery procedures. 

error recovery procedures (ERP): Standard procedures 
designed to ensure that all the routines that test partic- 
ular devices provide a uniform type and quality of in- 
formation. 

execute statement (EXEC): A job control statement that 
marks the beginning of a job step and identifies the pro- 
gram to be executed or the cataloged or in-stream pro- 
cedure to be used. 

existing VS2 system: A system the user has that is used 
as a generating system to process Stage I and Stage II. It 
is also a system that the user has and wants to change to 
include new or additional I/O devices, additional program 
options, or updates to include data management and 
user-written routines. 

external page storage: The portion of auxiliary storage 
that is used to contain pages. 

fixed BLDL table: A BLDL table that the user has speci- 
fied to be fixed in the lower portion of real storage. 



fixed link pack area: An extension of the link pack area 
that occupies fixed pages in the lower portion of real 
storage. 

fixed page: A page in real storage that is not to be paged 
out. 

GPS: Graphic programming services. 

graphic programming services (GPS): A number of 
services provided by the system for use in designing and 
executing programs that communicate with a user at an 
IBM 2250 Display Unit, an IBM 2260 Display Unit, or 
an IBM 2260 Display Station. 

group name: A generic name for a collection of I/O 
devices; for example, DISK or TAPE. See also device 
type, unit address. 

hard-copy: A printed copy of machine output in a 
visually readable form, for example, printed reports, 
listings, documents, and summaries. 

hard-copy log: In systems with multiple console support 
or a graphic console, a permanent record of system 
activity. 

hold queue: A waiting list in the SYS1 .SYSJOBQE data 
set for jobs whose initiation is to be delayed until the 
operator releases them from the queue. 

home address: An address written on a direct-access 
volume, denoting a track's address relative to the begin- 
ning of the volume. 

IBCDASDI: A program that initializes direct-access 
volumes, and assigns alternate tracks on direct-access 
storage volumes. 

ICAPRTBL: A program that loads the universal charac- 
ter set (UCS) buffer and forms control buffer (FCB) 
for an IBM 3211 Printer. 

IEBCOPY: A program that copies one or more parti- 
tioned data sets or merge partitioned data sets. Specified 
members of a partitioned data set(s) can be selected for, 
or excluded from, a copy operation. 

IEBEDIT: A program that can create an output data set 
containing a selection of jobs or job steps. At a later 
time, the data set can be used as an input stream for job 
processing. 

IEBPTPCH: A program that prints or punches all, or 
selected portions, of a sequential data set. Records can 
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be printed or punched to meet either standard specifi- 
cations or user specifications. 

IEBUPDTE: A program that incorporates source lan- 
guage modifications into sequential data sets or into 
partitioned data sets. 

IEHDASDR: A program that prepares direct-access 
volumes for use and ensures that any permanent machine 
errors (i.e. defective tracks) that are found on a direct- 
access volume do not seriously degrade the performance 
of those volumes. Also, this program can dump the 
entire contents or portions of a direct-access volume 
onto a volume or volumes of the same direct-access 
device type, onto a magnetic tape volume or volumes, 
or onto a system output device. 

IEHLIST: A program that can be used to list entries in a 
catalog, entries in the directory of one or more parti- 
tioned data sets, and entries in a volume table of con- 
tents. 

IEHPROGM: A program that allows the user to modify 
system control data and maintain data sets at an organi- 
zational level. This program can be used to: 

Scratch a data set or member 

Rename a data set or member 

Catalog or uncatalog a data set 

Build or delete an index or an index alias 

Connect or release two volumes 

Build and maintain a generation data group index 

IFCDIPOO: A program that is used to reinitialize the 
SYS1.LOGREC system data set in the event it is 
destroyed. 

IFCEREPO: A service aid that edits and writes records 
that are contained in the SYS1.LOGREC system data 
set. 

^initial program loader (IPL): The procedure that causes 
the initial part of an operating system or other program 
to be loaded such that the program can then proceed 
under its own control. 

initiator: The function of job management that is re- 
sponsible for interpreting job control statements, select- 
ing job steps for execution, satisfying resource requests 
for job steps, initiating job steps, and terminating job 
steps. 



input stream: The sequence of job control statements 
and data submitted to an operating system on an input 
unit especially activated for this purpose by the opera- 
tor. Synonymous with input job stream, job input 
stream. 

input work queue: A queue (waiting list) of job defini- 
tions in direct-access storage assigned to a job class and 
arranged in order of assigned priority. Synonymous 
with input queue, input job queue, job queue. 

installation verification procedure (IVP): A program 
that tests whether the newly installed System Control 
Program is operational and supports the installation's 
machine configuration. 

IPL: Initial program loader. 

IQADCMOO: A program that creates the DSS paging 
system data set SYS1.DSSVM. 

IVP: Installation verification procedure. 

I/O device generation: A type of system generation that 
can be performed against an existing system to add or 
delete I/O devices or channels, add universal character 
set support, change I/O device group names, or change 
console specifications. 

job processing: The reading of job control statements 
and data from an input stream, the initiating of job steps 
defined in the statements, and the writing of system out- 
put messages. 

job queue management: The part of job entry central 
services responsible for maintaining and managing the 
SYS1.SYSJOBQE data set. 

job scheduler: The part of the control program that 
reads and interprets job definitions, schedules the jobs 
for processing, initiates and terminates the processing 
of jobs and job steps, and records job output data. 



job stream: In system generation, the output from Stage 
I, consisting of the expansion of system generation macro 
instructions into job control language and control state- 
ments. 



line adapter: An IBM modem which is a feature of a 
particular device. 
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link pack area (LPA): An area of virtual storage contain- 
ing reenterable routines that are loaded at IPL and can 
be used concurrently by all tasks in the system. 

load module: The output of the linkage editor; a pro- 
gram in a format suitable for loading into virtual storage 
for execution. 

local system queue area (LSQA): One or more segments 
associated with each virtual storage region that contain 
job-related system control blocks. 

LPA: Link pack area. 

LSQA: Local system queue area. 

machine check handler (MCH): A feature that analyzes 
errors and attempts recovery by retrying the failing in- 
struction, if possible. If retry is unsuccessful, it attempts 
to correct the malfunction or to isolate the affected task. 

macro library: A library of macro definitions used dur- 
ing macro expansion. 

magnetic ink character recognition: The machine recog- 
nition of characters printed with magnetic ink. 

master console: In a system with multiple consoles, the 
basic console used for communication between the oper- 
ator and the system. 

master scheduler: A control program routine that 
responds to operator commands and initiates the re- 
quested action. 

MCH: Machine check handler. 

MICR: Magnetic ink character reader. 

*modem: (MOdulator-DEModulator) A device that 
modulates and demodulates signals transmitted over 
communication facilities. 

mount attribute: The attribute assigned to a volume 
that controls when the volume can be demounted; the 
mount attributes are permanently resident, reserved, and 
removable. 

multiplexor channel: A channel designed to operate with 
a number of I/O devices simultaneously. Several I/O de- 
vices can transfer records at the same time by interleaving 
bytes of data. 

mutually exclusive parameters: Parameters that cannot 
be coded on the same job control statement. 



new system: An entirely new System Control Program 
that has been generated. Or, an existing system that is 
changed to include support for new or more I/O devices, 
additional program options, or updates to data manage- 
ment and user-written routines. 

new system volume: The volume that contains system 
data sets into which modules or combinations of 
modules are placed during Stage II. 

NIP: Nucleus initialization program. 

nonpageable dynamic area: An area of virtual storage 
whose virtual addresses are identical to real addresses; it 
is used for programs or parts of programs that are not to 
be paged during execution. 

non-switched line: A connection between a remote 
terminal and a computer that does not have to be 
established by dialing. 

NRZI: Non-return-to-zero-inverted recording. 

nucleus initialization program (NIP): The program that 
initializes the resident control program; it allows the 
operator to request last minute changes to certain options 
specified during system generation. 

nucleus generation: The creation of a new nucleus for 
the System Control Program. 

*object module: A module that is the output of an 
assembler or compiler and is input to a linkage editor. 

OBJPDS: A partitioned data set used to store the object 
modules that are assembled during Stage II of system 
generation. 

*offline: Pertaining to equipment or devices not under 
control of the central processing unit. 

*online: Pertaining to equipment or devices under 
control of the central processing unit. 

online test executive program (OLTEP): An operating 
system facility that schedules and controls activities on 
the online test system and provides communication with 
the operator. This program is part of a set of programs 
that can be used to test I/O devices, control units, and 
channels concurrently with the execution of programs. 

*operating system: Software which controls the execu- 
tion of computer programs and which may provide 
scheduling, debugging, input/ output control, accounting, 
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compilation, storage assignment, data management, and 
related services. 

output queue: A queue of control information describ- 
ing system output data sets, which specifies to an output 
writer the location and disposition of system output. 

output stream: Diagnostic messages and other output 
data issued by the operating system or the processing 
program on output devices especially activated for this 
purpose by the operator. 

page: (1) A fixed-length block of instructions, data or 
both, that can be transferred between real 
and external storage. 
(2) To transfer instructions, data, or both between 
real storage and external page storage. 

page data set: A data set in external page storage, in 
which pages are stored. 

paging device: A direct-access storage device on which 
pages (and possibly other data) are stored. 

page frame: A block of real storage that can contain 
a page. 

pageable supervisor area: The area of virtual storage con- 
taining supervisor routines that can be paged into and 
out of real storage. 

paging: The process of transferring pages between real 
and external page storage to assist in allocating real stor- 
age among concurrently executing program. 

paging supervisor: A part of the supervisor that allocates 
and releases real storage space (page frames) for pages, 
and initiates page-in and page-out operations. 

partitioned data set: A data set in direct-access storage 
that is divided into partitions, called members, each of 
which can contain a program or part of a program. Each 
partitioned data set contains a directory (or index) that 
the control program can use to locate a program in the 
library. 

PDS: Partitioned data set directory. 

PID: Program Information Department. 

point-to-point line: A line that connects a single remote 
station to the computer; it may be either switched or 
non-switched. 

POR: Problem-oriented routine. 



primary paging device: An auxiliary storage device that 
is used in preference to secondary paging devices for 
paging operations. Portions of a primary paging device 
can be used for purposes other than paging operations. 
The primary paging device contains the link pack area. 

program options: Features of the VS2 System Control 
Program. 

qualified name: A data set name that is composed of 
multiple names separated by periods (e.g., A.B.C.). For 
a cataloged data set, each name corresponds to an index 
level in the catalog. 

queue: A waiting line or list formed by items in a system 
waiting for service; for example, tasks to be performed or 
output to be written by a writer. 

reader procedure: A cataloged procedure that controls 
the input stream reader. 

real storage: The storage of System/370 from which the 
central processing unit can directly obtain instructions 
and data, and to which it can directly return results. 

remote terminal: An input/ output control unit and one 
or more input/ output devices attached to a system 
through a telecommunications control unit. 

routing code: A code assigned to an operator message 
and used to route the message to the proper console. 

secondary console: In a system with multiple consoles, 
any console except the master console. 

secondary paging device: An auxiliary storage device 
that is not used for paging operations until the available 
space on primary paging devices falls below a specified 
minimum. Portions of a secondary paging device can be 
used for purposes other than paging operations. 

selector channel: A channel designed to operate with 
only one I/O device at a time. Once the I/O device is 
selected, a complete record is transferred one byte at a 
time. 

SMF: System management facilities. 

SQA: System queue area. 

Stage I: A single assembly of user-supplied macro in- 
structions with output consisting of job control language 
statements and utility control statements for Stage II 
assemblies, link-edits, and copies. 
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Stage II: The execution of job control language state- 
ments and utility control statements from Stage I to 
assemble, link-edit, and copy selected modules, specified 
by the Stage I macro instructions, into the new system. 

starter system: An IBM-supplied VS2 system consisting 
of a control program that supports any of the central 
processing units needed to perform a system generation, 
an assembler and linkage editor for Stage I and Stage II, 
and utility programs for a new system data set and volume 
initialization and Stage II processing. It is used when 
there is not an existing VS2 system with which to gen- 
erate a new system. 

step restart: A restart that begins at the beginning of a 
job step. The restart may be automatic or deferred, 
where deferral involves resubmitting the job. 

supervisor: The part of the control program that coor- 
dinates the use of resources and maintains the flow of 
CPU operations. 

supervisor call instruction (SVC): An instruction that 
interrupts the program being executed and passes control 
to the supervisor so that it can perform a specific service 
indicated by the instruction. 

SVC: Supervisor call instruction. 

SVC routine: A control program routine that performs 
or begins a control program service specified by a super- 
visor call. 

*system: An organized collection of men, machines, and 
methods required to accomplish a set of specific func- 
tions. 

system control program: A group of programs that (1) 
accept and schedule jobs in a continuous flow (job 
management); (2) supervise, on a sequential or priority 
basis, each unit of work to be done (task management); 
(3) simplify storage, retrieval, and maintenance of data, 
regardless of the way it is organized and stored (data 
management). 

system data set: A user-allocated data set on a new sys- 
tem volume. 

system generation: Obtaining VS2 components on tape, 
ordering a starter system if there is no existing system, 
planning the program options for the new system, speci- 
fying macros to include the options in the new system 
including the options by macro execution, executing the 
macro expansion to generate the new system, and testing 
the new system. 

•American National Standard Definition 



system initialization: The process of preparing job 
management for processing, including such functions as 
locating, cataloging, and formatting system data sets. 
System initialization is performed by the master scheduler 
at IPL. 

system log: Data sets on which the communication 
between problem programs, operators, and the system 
is recorded. 

system management facilities (SMF): A control program 
feature that provides the means for gathering and record- 
ing information that can be used to evaluate system 
usage. 

system queue area (SQA): A virtual area reserved for 
system-related control blocks and tables. 

system residence volume: The volume that contains the 
IPL program, the volume index of the SYSCTLG system 
data set, and the system data sets SYS1. NUCLEUS, 
SYS1.SVCLIB, and SYS1.LOGREC. The system resi- 
dence volume must reside on the I/O device which is 
addressed when initial program loading is performed. 

TCU: Teleprocessing control unit. 

teleprocessing control unit (TCU): An input/ output con- 
trol unit that addresses messages to and receives messages 
from remote terminals. 

temporary data set: A data set that is created and deleted 
in the same job. 

time-slicing: A feature that allows each task of speci- 
fied priority to have control of the CPU for a given 
interval of time. 

transient area: A virtual storage area used for temporary 
storage of transient routines, such as nonresident SVC or 
error-handling routines. 

UCS: Universal character set. 

unit address: The three-character address of a particular 
device, specified at system generation; for example, 191 
or 293. 

universal character set (UCS) feature: A printed feature 
that permits the use of a variety of character arrays. 

virtual address: An address that refers to virtual storage 
and must, therefore, be translated into a real storage 
address when it is used. 
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virtual storage: Addressable space that appears to the volume table of contents (VTOC): A table on a direct- 
user as real storage, from which instructions and data access volume that describes each data set on the volume, 
are mapped into real storage locations. The size of 

virtual storage is limited by the addressing scheme of the VTOC: Volume table of contents, 
computing system and by the amount of auxiliary stor- 
age available, rather than by the actual number of real writer procedure: A cataloged procedure that controls 
storage locations. the output stream writer. 
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Indexes for reference manuals are consolidated in OS I VS Master Index, GC28-0602. For additional information about 
any subject listed below, refer to other publications listed for the same subject in the Master Index. 



27 
48 



48,49 



ABEND codes, specifying 19 
ABSLTVEC (absolute vector) feature 63 

specifying 50, 54 
absolute vector (ABSLTVEC) feature 

IODEVICE macro 48,56 
accounting information, jobcard 

changing 152 
accounting routines, SMF 

contained in 126 

sample 142 
ACSMETH parameter 

DATAMGT macro 
adapter, transmission 

specifying 48, 52 

types of 68 
ADAPTER parameter 

IODEVICE macro 
adding channels 2,17-18 
adding I/O devices 2, 47-53 
adding load-modules 

to link library 24-25 
example of 145-146 

to link pack area 73-74 
example of 145-146 

to nucleus library 79 

example of 145-146, 147-148 

to resident portion LPA 69,73-74 
adding members to SYS 1. PARMLIB 69,73 
adding a nucleus 1, 145 

example of 179-180 

(see also nucleus generation) 
adding SVC routines 

to LPA library 73-74, 99-100, 145-146 

to nucleus library 79, 99-100, 145-146 
adding UCS support 3, 99-100 
adding user-written routines 

to link library 69-70 

example of 145-146, 147-148 

to LPA library 73-74, 99-100 

to nucleus library 79, 97-98, 138-139 
additional real storage 

allocating 24 
address, home 137 
address, unit (see unit address) 
ADDRESS parameter 

CHANNEL macro 17 

IODEVICE macro 49 
ALKYB2250 (alphameric keyboard) feature 50, 63 

specifying 54, 55, 57, 58 
ALKYB2260 (alphameric keyboard) feature 63 

specifying 55, 58 



allocation, space 

OBJPDS utility data set 15 1 

page data sets 77-79 
example of 79 

system data sets 3, 107-112, 113 

using the DATASET macro 29-33 
example of 108 

using IEHPROGM 108-110 
example of 110-112 

utility data sets 
Stage I 150 
Stage II 150,151 
alphameric keyboard feature 

ALKYB2250 63 

specifying 54, 55 , 57, 58 

ALKYB2260 63 
specifying 55, 58 
ALTCONS parameter 

SCHEDULR macro 82 

SECONSLE macro 94 
alternate channels 5 1-52 
APG parameter 

CTRLPROG macro 22 
AREA parameter 

SCHEDULR 82-83 

SECONSLE 94-95 
ASCII A character generator (ASCACHAR) feature 63 

specifying 55-56, 58 
ASCII B character generator (ASCBCHAR) feature 63 

specifying 55-56, 58 
ASCII typewriter keyboard (ASKY3277) feature 63 

specifying 55-56,58 
ASCII parameter 

CTRLPROG macro 22 
ASCII translation routine 22 
assumed control interval 62 
authorized program facility 99-100 
auto answer (AUTOANSR) feature 63 

specifying 60,61 
auto call (AUTOCALL) feature 63 

specifying 60, 61 
automatic polling (AUTOPOLL) feature 63 

specifying 50,59,60,61 
automatic calling unit 63 
automatic priority group, specifying 22 
automatic volume recognition (AVR) 88 



BDAM (basic direct access method) 27 

binary synchronous communications stations (BSC) 62, 64, 68 

BISAM (basic indexed sequential access method) 27 
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BLCMT parameter 

SCHEDULR macro 83 
BLDL table, fixed 23 
BLOCK parameter 

EDIT macro 35 
blocked multiplexor channel 17 
blocksize, system data sets 113 

specifying 

using the DATASET macro 31-32, 113 
using IEHPROGM 113 
BPAM (basic paritioned access method) 27 
broadcast messages 

specifying records for 83 
BSAM (basic sequential access method) 27 
BTAM (basic telecommunications access method) 27, 31 

contained in 134 

exclusion of 75 
buffer, WTO routine 89 
BUFFER4K feature 63 

specifying 54, 57 
BUFFER8K 63 

specifying 54, 57 
burst devices 47 



card images 

for restarting Stage II 1 16 

producing the job stream 150 
CARDIMAGE (card-image) feature 64 

specifying 59 
catalog, system 113, 114 

cataloging distribution libraries in 141, 144-145 

allocating space to 

using DATASET 29-33,108 
using IEHPROGM 108-112 

removing names from 163-164 
cataloging 

distribution libraries 141,144-145 

OBJPDS 151 

system data sets 

using the DATASET macro 29-33, 108, 113 
using IEHPROGM 108-112,113 
CENPROCS macro instruction 13, 15 
central processing unit (CPU) 

specifying 15 
channel 

alternate 51-52,94 

types 17 
CHANNEL macro instruction 13,17-18 

example of 18 

format of 17 

parameters 17 
character generation (CHARGNTR) feature 64 

specifying 57 
character set images, UCS 

default 103 

including in system 104 

table of 104 
CHARGNTR (character generation) feature 64 

specifying 57 



CHECKER parameter 

EDIT macro 35-36 
CHECKING (record checking) feature 64 

specifying 60 
CKPTREST macro instruction 13, 19 
codes, ABEND 19, 197 
codes, routing 

for the hard-copy log 84-85 

for the master scheduler 87 

for the secondary console 96 

for write-to-operator messages 86 
coding system generation macro instructions 3, 11-13 

(see also system generation macro instructions) 
column binary mode (CARDIMAGE) feature 64 

specifying 59 
commands 

console 96 

operator 85 

set address (SAD) 52 

start initiator 87-88 

start reader 88 

start writer 88 

system 85 

(see also SCHEDULR macro instruction) 
communication terminal (SCONTROL) feature 66 

IODEVICE macro 53,58 

specifying 60 
complete system generation 2 

example of 177-179 

GENERATE macro 41-43 

processing 154-160 

required macros 13 

(see also system generation) 
components of distribution libraries 160-163 
console 

alternate 

for the master console 82 

for the secondary console 93, 94 

specifying 90-91 

composite 

alternate 82,94 
master 83-84 
secondary 95 
valid devices 90-91 

devices 90-91 

for system generation 7-8 

integrated operators console 86 

master 83,90-91 

printing ESV messages 84 

secondary 93, 95 

specifying 57-59 
CONSOLE parameter 

SCHEDULR macro 83 

SECONSLE macro 95 
console specifications, changing 3 

(see also IODEVICE macro) 
control program 

macro instructions 23 

options 23-24 
control statements, utility program 

for punching the job stream 166 

IBCDASDI 139 

IBCDMPRS 139-140 
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control statements, utility program (continued) 

IEBCOPY 141, 144-145 

IEBEDIT 166-168 

IEBPTPCH 141-142, 166 

IEHDASDR 140-141, 143, 144 

IEHLIST 142 

IEHPROGM 110-112 

reallocate OBJPDS 170 

reallocate system data sets 170-174 
control unit, specifying 

graphic 50 

physical (PCU) 52 

transmission (TCU) 52 
CONVERT parameter 

EDIT macro 36 
copy distribution libraries to disk 141, 144-145 
creating new System Control Program 1, 2 
creating unique JOB statement 152 
CTRLPROG macro instruction 13, 21-26 

example of 27 

format of 21 

parameters 22-27 



data control block (DCB) 197 

defaults 30-31 

example of 110-112 

for system data sets 109, 113 
data conversion (DATACONV) feature 64 

specifying 56 
data extent block table 

size of 22 
data set page (see page data set) 

(see also PAGE macro instruction) 
data set, partitioned (see partitioned data set) 
data set, SYSPUNCH 149 
data set, system (see system data sets) 
data set, utility (see utility data sets) 
DATACONV (data conversion) feature 64 

specifying 56 
DATAMGT macro instruction 13, 27 
DATASET macro instruction 13, 29-33, 108 

example of 33, 108 

format of 29 

function of 29 

parameters 30-32 
DCB statement, how indicated 

for system data sets 
using DATASET 29 
using IEHPROGM 109,113 
default value, how indicated 

for system generation macro instructions 12 
DEBTINC parameter 

CTRLPROG macro 22 
DEBTSZE parameter 

CTRLPROG macro 22 
DEFAULT parameter 

UCS macro 103 
DEKYB2260 (alphameric keyboard) feature 64 

specifying 55 
DEKY3277 (EBCDIC data entry keyboard) feature 64 



deleting channels 3 

(see also CHANNEL macro instruction) 
deleting I/O devices 3 

(see also IODEVICE macro instruction) 
dependencies among parameters 1 3 
DESIGNFEAT (graphic design) feature 64 

specifying 54 
describing system generation macro instructions 12 
device 

address (see unitname) 

collection (see UNITNAME) 

console (see console) 

direct-access (see direct-access device) 

equivalent 52-53, 191 

HASP 53 

maximum number of 47 

model number of 50 

optional features 50,63-67 

specifying unit information 52, 54-62 

status 23 

types 183-184 

unsupported (DUMMY) 53 

(see also I/O device) 
device type 183-184 

for page data set 77-78 

for system residence volume 32, 42 
DEVTYPE parameter 

IODEVICE macro 49 
diagnostic messages 7 1 
diagnostic override 149, 193 
dial up (XCONTROL) feature 66 

specifying 60 
direct-access devices 54, 183-184 

specifying 54 

starter system configuration 7-10 

specifying group names for 105-106 
direct-access volumes 

initialization of 137,197 
using IBCDASDI 139 
using IEHDASDR 140-141 
display devices, specifying 54-56, 96 
distribution libraries 1, 2 

contents of 161-164 

distribution of 185 

copying to disk 141, 144-145 

removing names of 163-164 

selecting components from 1 
distribution library tape 

distribution of 185 

first file of 141, 144 

number of files 185 
DOCHAR (domestic character generator) feature 64 
documentation listing 

Stage I 150 

Stage II 163 
DSS (dynamic support system) 159 
dual communication interface (DUALCOMM) feature 64 

specifying 64 
dual code (DUALCODE) feature 64 

specifying 6 1 
dual density (DUALDENS) feature 64 

specifying 56, 57 
DUMMY device, specifying 53 
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DSTYPE parameter 

EDIT macro 36-37 
dumping starter system to disk 139-140 
dynamic system support (DSS) 159 



EBCDIC data entry keyboard (DEKY3277) feature 64 
EBCDIC typewriter keyboard (EBKY3277) feature 64 
EBKY3277 (EBCDIC typewriter keyboard) feature 64 
EDIT macro 13,25-38 

attribute defaults 38 

example of 38 

format of 35 

parameters 35-38 
EDITOR macro instruction 13, 39 
ELIGBLE parameter 

CKPTREST macro 19 
environment record editing and printing (EREP) 15 
ERP (error recovery procedures) 198 
errors 

common causes of 165 

in macro instructions 1, 149, 165 
error messages 

format of 187 
error routine, specifying 

user- written 49 
error volume analysis (EVA) 84 
ERRTAB parameter 

IODEVICE macro 49-50 
ESV (error statistics volume) message 84 
ESV parameter 

SCHEDULR macro 84 
EVA parameter 

SCHEDULR macro 84 
execution 

first system generation 5 

Stage I 150 

Stage II 153-163 

system generation 3 
excluding macros 

from macro library 75 
EXEC statement 

for executing Stage II 153 
EXCLUDE parameter 

MACLIB macro 75 
existing system 

as generating system 5-6 

modifying 1 

nucleus generation on 143, 145 
exit 

user 86 
EXPBFR parameter 

IODEVICE macro 49-50 
EXPRESS attention handling routines 49-50 



features, I/O device 

how to specify 50 

list of 54-62 

summary of 63-67 
FIXED parameter 

EDIT macro 36-37 
FORMAT parameter 

EDIT macro 37 
FRCHAR (French character generator) feature 64 



GCU parameter 

IODEVICE macro 50 
GENERATE macro instruction 1, 12-13, 41-43 

example of 43 

format of 41 

parameters 41-42 
generating system 5-6 

generating a secondary nucleus 145, 164 

modifying nucleus of 145 

(see also system generation) 
generation, system (see system generation) 
GENTYPE parameter 

GENERATE macro 41-42 
GPS (graphic programming services) 45 

exclude support of 75 
graphic control unit (GCU), specifying 50 
graphic design feature (DESIGNFEAT) 64 

specifying 54 
graphic programming services (GPS) 45, 198 

exclusion of 75 
graphic subroutine package (GSP) 45 
GRAPHICS macro instruction 13, 45 
GRCHAR (German character generator) feature 
Greenwich Mean Time 

how to specify 25 
group name, I/O device 198 

changing 3 

definition of 13 

specifying 47, 105-106 

UNITNAME macro instruction 
GSP (graphic subroutine package) 
GSP parameter 

GRAPHICS macro 45 
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105-106 
45 



hard-copy device 

specifying 84-85, 90-91 
hard-copy log 198 

specifying 84-85 
HARDCPY parameter 

high-speed multiplexor channel 

SCHEDULR 84-85,90-91 
home address 137, 198 - 



17 



FEATURE parameter 
specifying 54-62 
summary of 63-67 



50 



IBCDASDI utility program 139 
definition of 198 
punching from tape 141-142 
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IBCDMPRS utility program 139-140 

punching from tape 141-142 
ICAPRTBL utility program 198 

punching from tape 141-142 
IEAIPL00 (IPL text) 141-142 

including on system residence volume 143, 144 

punching from tape 141-142 
identification characters, specifying 12 
IEBCOPY utility program 141, 144, 198 

for restarting Stage II 169 

for Stage II execution 155, 156-157 
IEBEDIT utility program 168 

control statements for 168 

for restarting Stage II 166-168 

residence of 122 
IEBPTPCH utility program 141-142 

control statements for 166 

punching the job stream 166 

specifying sequence numbers 166 
IEBUPDTE utility program 5 

for restarting Stage II 169 

residence of 122 

processing the j ob stream 158 
IEHDASDR utility program 5, 140-141, 143 

control statements for 137, 141, 143 
IEHLIST utility program 5 

for restarting Stage II 170 

for Stage II processing 160 

residence of 122 

to prepare for system generation 138, 142 
IEHPROGM utility program 5, 107 

control statements for 110-112 

for allocating OBJPDS utility data set 15 1 

for initializing system data sets 108-1 10 
example of 110-112 

for reallocating OBJPDS utility data set 170 

for reallocating system data sets 163, 170-172, 174 
example of 172, 173 

for reallocating SYS 1. SYS JOBQE 169 

for restarting Stage II 168, 170 

for Stage II processing 154, 160 

residence of 122 
IFCDIP00 service aid 6, 123 

for restarting Stage II 169 

residence of 122 

Stage II execution 156 
IFCEREPO service aid 122 
images, UCS 

including in the system 103-104 
image library (see SYS1.IMAGELIB) 
IMAGE parameter 

UCS macro 103-104 
index of system data sets 41 

renaming during system generation 41, 160 
INDEX parameter 

GENERATE macro 42 
indexed sequential access method (ISAM) 27 
initial program loader (IPL) (see IPL) 
initialization, direct-access volume 137 

using IBCDASDI 139 

using IEHDASDR 140-141,143-144 
INTERRUPT feature 65 

specifying 60 



input, Stage I 149-150 
input, Stage II 151-153 
installation-supplied processor 

how to specify 35 
installation verification procedure (IVP) 175-176, 199 

residence of 130 
input/ output device, specifying (see IODEVICE macro 

instruction) 
I/O device generation 

definition of 2 

example of 180-181 

macro instructions required 13 

restrictions 2 
IODEVICE macro instruction 13, 47-68 

example of 53 

format of 48 

parameters 48-53 

for specifying a device type 54-62 
for telecommunication devices 68 
valid parameters for a device 54-62 
IOREQUE parameter 

IODEVICE macro 50 
I/O devices 

adding 2 

deleting 2 

how to include in system 47 

features of 63-67 

naming a group of 103-104 

starter system considerations 138 

types 183-184 

(see also IODEVICE macro instruction) 
I/O request queueing 

how to specify 50 
initiator procedure 129 
IPL (initial program loader) 199 

of the starter system 140 

specifying a new nucleus 164 
IPL text 

on system residence volume 143-144 

punching 141-142 
IQADCM00 utility program 6,199 
ISAM (indexed sequential access method) 27 
IVP (installation verification procedures) 175-176 
IVPJOBS 175 



job class, Stage II 
specifying 42 
job control language 1 

for creating a JOB statement 152 

for punching the job stream 166 

for reallocating data sets 170-171, 172-173 

example of 172, 173 
for reallocating OBJPDS 170 
Stage I input 149 

example of 150 
Stage II 151 

EXEC statement 153 
JOB statement 152 
job name, modifying 152 
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86 



86 



86 



86 



job queue space 86 
JOBQFMT parameter 

SCHEDULR macro 
JOBQLMT 

SCHEDULR macro 
JOBQTMT 

SCHEDULR macro 
JOBQWTP 

SCHEDULR macro 
job step, restarting 166 
job stream 1, glossary 

as card images 166 

contents of 151-153 

creating 150-151 

data set 150-151 

JOB statements 151-152 

processing 1, 153-160 

producing 1, 142 

punching 166 

restarting 150-151 

Stage I 149-151 

Stage II 143-145,155-158 
JOB statement, job stream 151-153 

modifying 152 



KACHAR (katakana character generator) feature 
KB70KEY (70-key keyboard) feature 65 
KB78KEY (78-key keyboard) feature 65 



65 



load-module, adding 

toSYSl.LINKLIB 69 
example of 145-148 

to SYS1.LPALIB 73, 99-100 
example of 145-148 

to SYS1. NUCLEUS 79, 99-100 
loader program 

input to 71 

options 71-72 

storage requirements 72 
LOADER macro instruction 13,71-72 

example of 72 

format of 71 

parameters 71-72 
local standard time 

how to specify 25 
local system queue area 

how to specify 

numbers of cells 23 
size of 23 
total size of 23 
LOGON 

how to issue 101 
LOGLINE parameter 

TSO macro 101 
LOGTIME parameter 

TSO macro 101 
LPALIB macro instruction 13, 73-74 

example of 74 

format of 73 

parameters 73 
LSQACEL parameter 

CTRLPROG macro 23 



LIB parameter 

LOADER macro 71 
LIN parameter 

LOADER macro 71 
line addressing (LINEADDR) feature 65 

specifying 55, 58 
light pen (LIGHTPEN) feature 65 

specifying 55,57 
link library (see SYS1.LINKLIB) 
link pack area 124 

adding members 

to the resident part 69, 73 
using LINKLIB 69 
using LPALIB 73 

adding user-written routines 
using LINKLIB 69 
using LPALIB 73 
linkage editor 5 

options 39 
LINKLIB macro instruction 13,69-70 

example of 70 

format of 69 

function of 69 

parameters 69 
listing, documentation 

Stage I 150 

Stage II 163 



machine configuration 1 

example of 7, 177 

starter system 
maximum 7 
minimum 8-9 
MACLIB macro instruction 13, 75 
MAGCARD (magnetic card) feature 65 
magnetic ink character reader 

how to specify 57, 184 
magnetic tape drives 

device types 183 

restarting from 166-168 

starter system configuration 7-9 

starter system consideration 138 
macro library (see SYS 1. MACLIB) 

macro instructions (see system generation macro instructions) 
master console 83, 90-91 
master scheduler options, specifying 82-89 
maximum size of real storage, specifying 24 
MAXIO parameter 

CTRLPROG 23 
MDECOMPAT (mode compatability) feature 65 

specifying 56 
MEMBERS parameter 

LINKLIB macro 69 

LPALIB macro 73 
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MEMBERS parameter (continued) 

RESMODS macro 79 
messages, diagnostic 71 
mode compatibility (MDECOMPAT) feature 

specifying 56 
MODEL parameter 

CENPROCS macro 15 

IODEVICE macro 50 
multiplexor channel 17, 200 
MULTILINE (multiple line print) feature 65 



65 



NAME parameter 

UNITNAME macro 105 
NODESCUR (nondestructive cursor) feature 65 

specifying 55, 58 
non-supported device, specifying 53 
NMKYB2260 (numeric keyboard) feature 65 

specifying 55 
NOTELIG parameter 

CKPTREST macro 19 
NRZI tape units 65 
nucleus 

adding another 145 

members included in 79 

modifying a 145 

primary 164 

renaming the 164 
nucleus generation 1, 200 

adding entries to trace table 25 

example of 179-80 

macros required 13 

on generating system 145 
nucleus initialization program (NIP) 140, 200 
nucleus library (see SYS 1. NUCLEUS) 
nucleus-identification, including 147-148 
numeric keyboard feature 65 

specifying 55 
NUMSECT parameter 

IODEVICE macro 50-51 



OBJPDS parameter 

GENERATE macro 42 
OBJPDS utility data set 3, 151, 200 

allocation, space 151 

cataloging 151 

reallocating 170 
OBRCNT parameter 

IODEVICE macro 51 
OCKY3277 (78-key operator console keyboard) feature 65 
OCR (optical character reader) 

device type 184 

exclusion of support 75 

specifying 57 
offline volume initialization 138, 140-141, 143, 144 
OIU (optical image unit) feature 66 

specifying 60 



OLDWTOR parameter 

SCHEDULR macro 86 
online status 200 
OPTCHAN parameter 

IODEVICE macro 51-52 
optical character reader 

device type 184 

exclusion of support 75 

specifying 57 
optical image unit (OIU) feature 66 

specifying 60 
optional channel paths 5 1-5 2 
optional system data sets 113 
OPTIONS parameter 

CTRLPROG macro 23-24 
OUTCLS parameter 

TSO macro 101 
output class 

for Stage II 42 

for write-to-log messages 89 



page data set 

definition of 77,201 
how to specify 

device address of 78 
device type 78 
link pack area residence 77 
size of 77-78 

volume serial number of 78 
page device types 77 
parameters 77-78 
page frame 

clearing to zeros 24 
PAGE macro instruction 13,77-78 
example of 78 
format of 77 
pageable link pack area 
device for 77 
how to specify 
device for 77 
primary device 78 
secondary device 78 
PARM parameter 

LOADER macro 71-72 
partitioned data set 201 
directory of 31-32 
in the new system 113 
PCU parameter 

IODEVICE macro 52 
PDS (partitioned data set directory), listing 
PDS parameter 

LINKLIB macro 69 
LPALIB macro 73 
RESMODS macro 79 
PFK command entry 87, 95-96 
PFK parameter 

SCHEDULR macro 87 
SECONSLE macro 95-96 
PGCLEAR parameter 
CTRLPROG macro 24 



160, 201 
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physical control unit, specifying 52 
PORRTNS parameter 

GRAPHICS macro 45 
primary nucleus 145, 164 
PRGMKYBD (programmed function keyboard) feature 66 

specifying 55-56, 57 
problem-oriented routines (POR) 201 

inclusion of 45 
procedures for system generation 

with existing system 137-143 

with starter system 143-145 
producing the job stream 149 
program products 175 

programmed-function keyboard (PFK) command entry 87, 95-96 
programmed-function keyboard (PRGMKYBD) feature 66 

specifying 55-56, 57 
programming options 1, 201 

programming requirements for system generation 5-6 
PUNCH statements 150 
punching out 

IBCDASDI 141-142 

IBCDMPRS 141-142 

ICAPRTBL 141-142 

IPLtext 141-142 

job stream 166 

SMF sample routines 141-142 



QISAM (queued indexed sequential access method) 
QSAM (queued sequential access method) 27 
QSPACE parameter 

CTRLPROG macro 24 
qualified name 42, 201 
queue 201 



27 



removing names from system catalog 163 
renaming the nucleus 164 
reply queue elements 87 
required system data sets 113 
resident link pack area 

adding members to 69, 73 
RESIDNT parameter 

LINKLIB macro 69 

LPALIB macro 73 
RESMODS macro instruction 13, 79, 99 
restarting system generation 4 

from assemblies 168, 169 

from cards 166 

from disk 166-168 

from tape 166-168 

IEBCOPY step 169 

IEBUPDTEstep 169 

IEHLISTstep 170 

IEHPROGMstep 168-170 

IFCDIPOOstep 169 

link-edit steps 169 

nucleus link-edit 169 

Stage I 165 

Stage II 165-168 
guidelines 168-170 
tape 166-168 

techniques 165-168 
RESVOL parameter 

GENERATE macro 42 
ROUTCDE parameter 

SCHEDULR macro 87 

SECONSLE macro 96 
routing codes 201 

for hard-copy log 85 

for master console 86, 87 

for secondary console 96 

for write-to-operator messages 85 



reader, starting a 

atlPL 142 

automatic 88 
reader procedure 129,201 
real-storage 

for system generation 7 
reallocating OBJPDS utility data sets 170 
reallocating system data sets 170-174 
record checking (CHECKING) feature 64 

specifying 60 
READWRITE (simultaneous read-write control unit) feature 66 

specifying 56 
real-storage 201 
real-storage requirements 

for system generation 5 
reallocation 

of OBJPDS utility data set 170 

of system data sets 170-174 
reduced error recovery 23 
reliability data extractor feature 24 



scheduler 

job 81 

master 81 
SCHEDULR macro instruction 13,8 1-92 

example of 92 

format of 81 

parameters 82-89 
SCONTROL (communication terminal) feature 

specifying 60 
SECMODS parameter 

CENPROCS macro 15 
secondary console 

specification of 94 
secondary nucleus 

generation of 145 
SECONSLE macro instruction 13, 93-97 

example of 97 

format of 93 

parameters 92-96 

routing codes, specifying 96 
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SELCHSET (selective character set) feature 66 

specifying 58 
selector channel 18 
sequential access device 

group names of 10, 105-106 
serial number, specifying 

of data set volumes 32 

of the system residence volume 42 
service aid programs 122 
set address (SAD), commands 52 
SETADDR parameter 

IODEVICE macro 52 
SHARABLE feature 66 

specifying 57 
SHARED (shared direct-access storage devices) feature 66 

specifying 56 
simultaneous read-write control unit (READWRITE) feature 

specifying 56 
size of system queue area 24 
SIZE parameter 

EDITOR macro 39 

PAGE macro 77-78 
space allocation 

for OBJPDS utility data set 150 

for system data sets 107 

using DATASET 29-32, 108 
using IEHPROGM 108-112 

for Stage I utility data sets 149-150 

for Stage II utility data set 150 
SPACE parameter 

DATASET macro 31-32 
specifying sequence numbers 

for the job stream 166 
SQACEL parameter 

CTRLPROG macro 24 
Stage I 1, 2, 149, 201 

DD statements for 150 

documentation listing 150 

execution of 150 

input 149 

input deck 149-150 

output 150-151 

producing the job stream 1,149 

restarting 165 

utility data set allocation 150 
Stage II 1,2,151,202 

completion of 2 

DD statements 152 

documentaion listing 163 

EXEC statements 153 

execution of 153-160 

input 151-153 

input deck 151-153 

job class 

specifying 42 

JOB statement 152 

OBJPDS utility data set 
allocation of 15 1 

output 163 

output class 

specifying 42 

processing the job stream 153-163 



Stage II (continued) 
restarting 165 

guidelines 168-170 
techniques 165-168 
utility programs used 5-6 
standard access methods 27 
start initiator command 140 
start reader command 140 
start writer command 140 
starter system 5-6, 202 
contents of 6 

initializing the volume for 139 
IPL procedures 140 
I/O devices 

dumping to disk 139-140 
maximum requirement 7 
66 minimum requirement 8-9 

processing 137, 139 
special considerations 138 
starting 140 
tape, first file 137 
START INIT command 140 
START RDR command 140 
START WTR command 140 
STARTI parameter 

SCHEDULR macro 87-88 
STARTR parameter 

SCHEDULR macro 88 
STARTW parameter 

SCHEDULR macro 88 
statement sequence characteristics 12 
storage requirements (see space allocation) 
SUBMITQ parameter 
TSO macro 101 
supervisor call routines (see SVC routines) 
SVC library (see SYS1.SVCLIB) 
SVC routines 202 
type 1 79, 99-100 
type 2 79, 99-100 
type 3 73,99-100 
type 4 73,99-100 

user-written, specifying 73, 79, 99-100 
example of 145-147 
SVC table 99 

SVCTABLE macro instruction 99-100 
example of 100 
format of 99 
system catalog (SYSCTLG) 1 13, 1 14 
allocation of 

using DATASET 29-33, 108 
using IEHPROGM 108-112 
cataloging distribution libraries 141, 145-146 
removing names from 163 
System Control Program 1, 202 
installation of 149-163 
testing 175-176 

(see also system generation macro instructions) 
system data sets 1, 113, 202 
allocating space for 107 

using DATASET macro 29-33,108 
using IEHPROGM 108-112 
cataloging 29,107-110 



Index 213 



system data sets (continued) 
device types for 29-33 
generated from 160-163, 185 
names of 

SYSCTLG 113,114 

SYS1.BRODCAST 113,115 

SYS1.CMDLIB 113, 116 

SYS1.DCMLIB 113, 117 

SYS1.DSSVM 113, 118 

SYS1.DUMP 113, 119 . 

SYS1.HELP 113, 120 

SYS1.IMAGELIB 113,121 

SYS1.LINKLIB 113, 122 

SYS1.LOGREC 113, 123 

SYS1.LPALIB 113,124 

SYS1.MACLIB 113, 125 

SYS 1. MANX 113, 126 

SYS 1. MANY 113, 126 

SYS 1. NUCLEUS 113, 127 

SYS1.PARMLIB 113,128 

SYS1.PROCLIB 113,129 

SYS1.SAMPLIB 113, 130 

SYS1.SVCLIB 113, 131 

SYS1.SYSJOBQE 113,132 

SYS1.SYSVLOGX 113, 133 

SYS1.SYSVLOGY 113,133 

SYS1.TELCMLIB 113, 134 

SYS1.UADS 113, 135 
optional 113 
reallocation of 170-174 
renaming the index of 41, 160 
required 113 

space allocation {see space allocation) 
summary of 112-113 
system generation 1, 2, 202 
complete 1 
definition of 1 
first 137-138 
I/O device 2 

job stream processing 151-164 
machine requirements for 7-9 

macro instructions {see system generation macro instructions) 
messages 187-190 
nucleus 1 

on generating system 145,163-164 
process 3-4 

programming requirements 5-6 
real-storage requirement 5 
restart 

Stage I {see Stage I) 

Stage II {see Stage II) 
starter system requirements 6 
using existing system 5-6 

preparation 137, 143-145 
using the starter system 5 

preparation 137-143 
system generation macro instructions 1, 2 
coding 3, 11-12 
describing 12-13 
example of coding 12 

for a complete generation 178-179 

for an I/O device generation 180-181 

for a nucleus generation 179-180 



system generation macro instructions (continued) 
execution of 149 
names of 

CENPROCS 13, 15 
CHANNEL 13, 17-18 
CKPTREST 13, 19 
CTRLPROG 13, 21-26 
DATAMGT 13,27 
DATASET 13,29-33 
EDIT 13, 35-38 
EDITOR 13,39 
GENERATE 13,41-43 
GRAPHICS 13,45 
IODEVICE 13,47-68 
LINKLIB 13,69-70 
LOADER 13,71-72 
LPALIB 13,73-74 
MACLIB 13,75 
PAGE 13,77-78 
RESMODS 13,79 
SCHEDULR 13, 81-92 
SECONSLE 13,93-97 
SVCTABLE 13,99-100 
TSO 13, 101-102 
UCS 13, 103-104 
UNITNAME 13, 105-106 
optional 1 3 
required 13 
selecting 13 
summary of 12-13 
system job queue, specifying 
for TSO 101 
size of 24 
system log 85,202 

residence 133 
system management facility (SMF) 202 

sample accounting routines, punching 141-142 
system data sets for 113, 126 
system queue area, specifying 24 
system residence volume 202 
including IPL text on 143, 144 
initialization of 143, 144 
serial number of, specifying 42 
valid devices for 8, 9, 42 
system trace table entries 25 
SYS1.AGENLIB 162,197 

allocation of 141, 144-145, 150 
cataloging 141, 144-145 
distribution of 185 
SYS1.AMACLIB 161 

cataloging 141, 144-145 
distribution of 185 
SYS1.AMODGEN 162,197 
cataloging 141, 144-145 
distribution of 185 
SYS1.APARMLIB 161 
cataloging 141, 144-145 
distribution of 185 
SYS1.APROCLIB 161 
cataloging 141, 144-145 
distribution of 185 
SYS1.ASAMPLIB 161 
cataloging 141, 144-145 
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SYS1.ASAMPLIB (continued) 
distribution of 185 
punching contents of 141-142 
SYS1.ATCAMMAC 161 
SYS1.BRODCAST 83,113,115 
allocating space to 

using DATASET 29-33, 108 
using IEHPROGM 108-112 
generation of 154 
SYS1.CMDLIB 113, 116 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
generated from 162, 163 
generation of 154, 159 
SYS1.DCMLIB 2, 29, 87, 96, 117 
allocating space to 107 

using DATASET 29-33,108 
using IEHPROGM 108-112 
generated from 160,162 
generation of 154, 159 
SYS1.DSSVM 113, 118 
allocating space to 107 

using DATASET 29-33,108 
using IEHPROGM 108-112 
SYS1.DUMP 29, 113 
SYS1.HELP 113, 120 
allocating space to 

using DATASET 29-33, 108 
using IEHPROGM 108-112 
generation of 154, 155 
SYS1.IMAGELIB 2,29,113 
allocating space to 

using DATASET macro 29-33, 108 
using IEHPROGM 108-112 
generated from 154,157,159 
generation of 163 
SYS1.LINKLIB 2, 29, 113, 122 

adding user-written routines to 69-70, 145-146 
allocating space to 

using DATASET macro 29-33, 108 
using IEHPROGM 108-112 
generated from 160-163 
generation of 154,156-159 
reallocation of 168 
SYS1.LOGREC 2, 30, 113, 123 
allocating space to 30, 32, 113 
generation of 156 
SYS1.LPALIB 29,113,124 

adding user-written routines to 73-74, 99-100 
allocating space to 107 

using DATASET 29-33,108 
using IEHPROGM 108-112 
generated from 160-163 
generation of 154, 155, 157, 159 
SYS1.MACLIB 113, 125 
allocating space to 

using DATASET 29-33,108 
using IEHPROGM 108-112 
excluding members from 75 
generated from 160,161 
generation of 154, 155 



SYS1.MANX 113, 126 
allocating space to 

using DATASET 29-33,108 
using IEHPROGM 108-112 
writing SMF records to 84 
SYS 1. MANY 113, 126 
allocating space to 

using DATASET 29-33,108 
using IEHPROGM 108-112 
writing SMF records to 84 
SYS1.NUCLEUS 2, 29, 113, 127 

adding user-written routines to 79, 99-100 

example of 145-148 
allocating space to 107 

using DATASET 29-33,108 
using IEHPROGM 108-112 
generated from 160,161,162 
generation of 154, 157, 158, 159 
SYS1. PAGE (see page data set) 
SYS1.PARMLIB 2, 29, 113, 128 
adding members to 69, 73, 77 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
generated from 161 
generation of 154,155,158 
reallocation of 173 
SYS1.PROCLIB 113, 129 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
generated from 161 
generation of 154,155 
SYS1.SAMPLIB 113,130 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
generated from 161 
generation of 154, 155 
installation verification procedure 175-176 
obtaining IPL text from 141-142, 143 
punching independent utilities from 141-142, 143 
SYS1.SVCLIB 2,29,113,131 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
generated from 160, 161, 162, 163 
generation of 154, 157 
SYS1.SYSJOBQE 107, 113, 132 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
buffers for 85 
generation of 85 
number of records for 86 
SYS1.SYSVLOGX 113,133 
allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 
write-to-log buffers 
specifying 88-89 
SYS1.SYSVLOGY 113,133 
allocating space to 

using DATASET 29-33 
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SYS 1 . S YSVLOGY (continued) 

allocating space to (continued) 
using IEHPROGM 108-112 

write-to-log buffers 
specifying 88-89 
SYS1.TELCMLIB 31,113,134 

allocating space to 

using DAT ASET 29-33 
using IEHPROGM 108-112 

generated from 160, 162 

generation of 154, 157 
SYS1.UADS 31, 113, 135 

allocating space to 

using DATASET 29-33 
using IEHPROGM 108-112 

generation of 154, 155 



tape 

device types 183 

restarting from 166 

starter system configuration 7-9 

starter system considerations 138 

specifying a group name for 10, 105-106 

specifying for new system 56-57 

(see also IODEVICE macro) 
tape distribution 

of distribution libraries 185 

of starter system 185 
tape drives, 7-track 

specifying 56-57,67 

starter system configuration 7-9 
tape drives, 9-track 

specifying 67 

starter system configuration 7-9, 138 
TCAM 27, 101, 134, 162 
TCU parameter 56-57 

IODEVICE macro 52 
telecommunications 202 

device types 183-184 

lines 47 

specifying 47,59-61,68 
telecommunications access method, basic (BTAM) 

specifying 27, 134, 162 
telecommunications access method (TCAM) 

specifying 27, 101, 134, 162 
telecommunications library (see SYS1.TELCMLIB) 
telecommunications subroutines 

residence of 160, 162 
telegraph adapters, specifying 68 
terminal adapters, specifying 68 
testing the system 4, 175-176 

(see also installation verification procedure) 
time-slice group 25-26 
time-slicing facility 24-25 
TMSLICE parameter 

CTRLPROG macro 24-25 



TRACE parameter 

CTRLPROG macro 25 
trace table entries, specifying 25 
tracing routine, specifying 25 
translate routine, ASCII 22 
transmission adapter, specifying 48, 68 
transmission control unit (TCU) 

(see TCU parameter) 
TSO 

auxiliary storage 102 

EDIT command 35-38 

excluding 75 

specifying 27, 101-102 

system 35 
TSO macro instruction 13, 101-102 

example of 102 

format of 101 

parameters 102 
TSOAUX parameter 

TSO macro 101-102 
TWOLINE feature 66 
TYPE parameter 

CHANNEL macro 17 
TZ parameter 

CTRLPROG macro 25 



UCS macro instruction 13, 103-104 

example of 104 

format of 103 

parameters 103-104 
UKCHAR (United Kingdom character generator) feature 66 
unit address 

coding a 13 

specifying a 49 

(see also unit address, specifying) 
unit address, specifying 

of an alternate channel 5 1 

of an alternate console 82, 94 
figure of 90-91 

of a composite console 82-94 
figure of 90-91 

of a device 49 

of an equivalent device 52-53, 191 

of a group of devices 101-102 

of a HASP device 52-53 

of a master console 83-84 
figure of 90-91 

of a page data set 78 

of a secondary console 95 
figure of 90-91 

of a telecommunications line 48-49 

of an unsupported device 5 2-5 3 

(see also UNIT parameter, SECONSLE and SCHEDULR 
parameters) 
unit name 

specifying 13, 105-106 
UNIT parameter 

IODEVICE macro 52-53,54-62,63-67,68 

PAGE macro 78 

UNITNAME macro 105-106 
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UNITNAME macro instruction 13, 105-106 

example of 106 

format of 105 

parameters 105-106 
universal character set (UNVCHSET) feature 66 

specifying 58 
universal character set support 

(see UCS macro) 
USE parameter 

SECONSLE macro 96 
USEREXT parameter 

EDIT macro 37 
USERSRC parameter 

EDIT macro 37 
user-written ABEND codes, specifying 19 
user- written routines, inclusion of 

in link library 69-70, 145-146 

in LPA library 73-74, 99-100, 145-146 

in nucleus library 79, 99-100, 145-148 
utility data sets 

for Stage I 149-150 

for Stage II 150,151 
reallocation of 170 
(see also OBJPDS utility data set) 
utility program functions 

allocating space to system data sets 107, 108-110 
example of 1 1 0-112 

copying tape to disk 141, 144 

initializing direct-access volumes 1 37 
using IBCDASDI 137,139 
using IEHDASDR 137,140-141 

listing system data 138,142 

processing the job stream 151 

punching independent utilities from disk 141-142 

punching IPL text from disk 141-142 

punching the job stream 165-166 

reallocating data sets 170-171 

reallocating OBJPDS 170 

removing names from S YSCTLG 163 

required for system generation 5-6 

restart techniques 165-168 
from cards 166 
from disk 166-168 
from tape 166-168 
punching the job stream 165-166 

restarting Stage I 165 

restarting Stage II 165,168-170 
utility programs 

contained in 163 

resident of 122 



VALDCMD parameter 
SECONSLE macro 
VAR parameter 

EDIT macro 38 
varying devices offline 
varying devices online 
virtual storage 203 
for linkage editor 



96 



138, 150-151, 143, 144 
138, 150-151, 143,144 

39 



VOL parameter 

DATASET macro 32 

VOLNO parameter 
PAGE macro 78 

volume error statistics (ESV) records 84 

volume initialization 
definition of 137 
using IBCDASDI 137,139 
using IEHDASDR 137,140-141 

volume table of contents (VTOC) 203 
listing 142 



write-to-log messages 84, 85, 86 
write-to-operator messages 84, 85, 86 
write-to-programmer routines 

specifying number of records for 86 
writer 
starting 

at IPL 140 
automatic 88 
writer procedure 129, 203 



XCONTROL (dial-up) feature 

specifying 60 
XCTL table 

residence of 122 



66 



7-track magnetic tape 

device types 183 

specifying 56 

starter system configuration 7-8 
9-track magnetic tape 

device types 183 

specifying 56 

starter system configuration 7-8 
83B3, specifying 61 
1 15 A, specifying 60 
1030 

features 63 

specifying 59 
1050 

features 63 

specifying 60 
1053 

device type 183 

specifying 54 
1060 

features 60 

specifying 63 
1130 

specifying 62 
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1275 

device type 184 

specifying 50 
1287 

device type 184 

specifying 57 
1288 

device type 1 84 

specifying 57 
1403 

device type 183 

features 66 

specifying 58, 90 

starter system device 7-9 

UCS images for 103-104 
1419 

device type 184 

specifying 57 
1443 

device type 183 

features 66, 67 

specifying 58, 90 
1800 

specifying 62 
2250 

device type 184 

features 63,64,65,66 

specifying 54-55,57-58,83,90,95 
2260 

device type 184 

features 63,64,65 

specifying 55,58,83,95 
2265 

device type 184 

specifying 55 
2305 

device type 183 

specifying 54 

starter system device 7-9 

system residence device 42 
2314 

device type 183 

features 66 

specifying 54 

starter system device 7-9 

system residence device 42 
2319 

description 191 

specifying 52-53 
2400 

device type 183 

starter system device 7-9 
2401 

features 65, 66, 67 

specifying 56 
2420 

specifying 56 
2495 

device type 183 

specifying 56 
2501 

device type 183 

features 64 



2501 (continued) 

specifying 59, 90 
2520 

device type 183 

features 64 

specifying 59, 90 
2540 

device type 183 

specifying 59, 90 

starter system device 7-9 
2671 

device type 183 

specifying 59 
2701 

specifying 52, 68 
2702 

specifying 52, 68 
2703 

specifying 52, 68 
2740 

features 63,64,65,66 

specifying 60 
2741 

features 63 

specifying 60 
2770 

specifying 62 
2780 

specifying 62 
2790 

specifying 62 
2848 

specifying 50 
2955 

specifying 47,61 
2972 

specifying 62 
3066 

device type 183 

specifying 58,83,90,95 

starter system device 7-9 
3158 

device type 183 

features 64, 63, 66 

specifying 55,58,83,90 
3210 

device type 184 

specifying 58 

starter system device 7-9 
3211 

device type 184 

specifying 59,90 

starter system device 7-9 

UCS images for 103-104 
3213 

device type 184 

specifying 59,91 
3215 

device type 184 

specifying 58, 90 

starter system device 7-9 



218 OS/VS2 System Generation Reference 



3275 

specifying 62 
3277 

device type 184 

features 64, 65, 66 

specifying 55-56, 58, 83, 90, 95 
3284 

device type 184 

features 64, 65 

specifying 56, 90 
3286 

device type 184 

features 64,65,90 

specifying 56 
3330 

device type 179 

features 66 

specifying 48, 54 

starter system device 7-9 

system residence device 42 
3333 

description 191 

specifying 52-53 
3400 

description 183 



3400 (continued) 

starter system device 7-9 
3410 

device type 183 

features 64, 67 

specifying 57 
3420 

device type 183 

features 64, 67 

specifying 56 
3505 

device type 184 

features 64 

specifying 59 
3525 

device type 183 

feature 64, 65, 66 

specifying 59 
3670 

specifying 62 
3735 

specifying 62 
7770 

device type 184 

specifying 61 



Index 219 



0S/VS2 System Generation Reference Reader's 

GC26-3792-1 Comment 

Form 



Your comments about this publication will help us to improve it for you. 
Comment in the space below, giving specific page and paragraph references 
whenever possible. All comments become the property of IBM. 

Please do not use this form to ask technical questions about IBM systems and 
programs or to request copies of publications. Rather, direct such questions or 
requests to your local IBM representative. 

If you would like a reply, please provide your name, job title, and business 
address (including ZIP code). 



Fold on two lines, staple, and mail. No postage necessary if mailed in the U.S.A. (Elsewhere, 
any IBM representative will be happy to forward your comments.) Thank you for your 
cooperation. 



GC26-3792-1 



Fold and Staple 



First Class Permit 

Number 2078 

San Jose, California 



O 
CO 

< 

CO 
NJ 

CO 
< 



Business Reply Mail 

No postage necessary if mailed in the U.S.A. 



Postage will be paid by. 



IBM Corporation 
Programming Center -Publishing 
Department D58 
Monterey and Cottle Roads 
San Jose, California 95193 




CD 

3 



O 

3 



2 
p 

CO 
CO 

o 

CO 



-o 
5' 

r+ 
CD 

a 
5' 

c 

CO 

> 

a 
o 

NJ 
Ol 

CO 
vj 
CO 



Fold and Staple 



International Business Machines Corporation 

Data Processing Division 

11 33 Westchester Avenue, White Plains, New York 10604 

(U.S.A. only) 



IBM World Trade Corporation 

821 United Nations Plaza. New York, New York 10017 

(International) 



GC26-3792-1 



International Business Machines Corporation 

Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 

(U.S.A. only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(International) 



O 
co 

< 

co 
ro 

CO 

< 



3 
O 



o 

33 



CO 
CO 
>J 
O 
GO 



5' 

r+ 
CD 
Q. 

5' 

c 

CO 

> 

o 
a 

a> 

GO 

>sl 

CD 



